New Recipe - Cove - ClientTool - Export Session File Lists

Export Cove Backup session file node lists to CSV using the local ClientTool.exe utility. Select sessions interactively, filter files by wildcard path pattern, and tag each file as Changed, Unchanged, or Removed. Supports all ClientTool datasources including FileSystem, SystemState, VssMsSql, and more.

https://developer.n-able.com/n-able-cove/update/recipes/cove-clienttool-export-session-file-lists

This script uses the Cove Backup Manager ClientTool.exe command-line utility to enumerate backup sessions for a given datasource, presents them in an interactive Out-GridView picker, then retrieves the file node list for each selected session and exports it to CSV.

Key Features

Multi-select sessions via Out-GridView (sorted oldest → newest)
Supports all 10 ClientTool datasources: Exchange, FileSystem, MySql, NetworkShares, Oracle, SystemState, VMware, VssHyperV, VssMsSql, VssSharePoint
Filter exported files by wildcard path pattern (-PathFilter):
```
Prefix:     'C:\Users*'
Contains:   '*\Rapid7*'
Ends-with:  '*.log'
Combined:   '*\logs\*.txt'
```
Omit for no filter (export all files).
Tags each file with State: Changed, Unchanged, or Removed
Rolling elapsed time and estimated time to completion after each session
Append-mode structured run log (Clienttool-Export-SessionFiles.log)
CSV output pattern: {device}_{DataSource}_session_{starttime}.csv

Requirements

PowerShell 5.1+
N-able Cove Data Protection Backup Manager installed (local agent)
ClientTool.exe at default path or supplied via -ClientToolPath parameter

Run Get-Help .\Clienttool-Export-SessionFiles.V01.1.ps1 -Full for complete parameter documentation and usage examples.