Find-VBRTapeCatalogItem

Short Description

Looks for files or folders backed-up by tape jobs.

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

Find (Default)

Find-VBRTapeCatalogItem [-Server <CHost>] [-CatalogItem <VBRTapeCatalogItem[]>] [-Name <String[]>] [<CommonParameters>]
ResolvePath

Find-VBRTapeCatalogItem -CatalogItem <VBRTapeCatalogItem[]> [-ResolvePath] [<CommonParameters>]

Detailed Description

This cmdlet looks for files or folders backed-up by tape jobs.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
CatalogItem	Specifies a file or folder. This parameter is used to search further based on the results of the initial search without this parameter. Accepts the `VBRTapeCatalogItem[]` object. To get this object, run the `Find-VBRTapeCatalogItem` cmdlet.	`VBRTapeCatalogItem[]`	False	Named	False
Name	Specifies the name of the file or folder. The cmdlet will filter files and folders by this value.	`String[]`	False	Named	False
ResolvePath	Defines that the cmdlet will set correct path for all returned files or folders. It is used to view the full path to existing files or folders.	`SwitchParameter`	True	Named	False
Server	Specifies the server where files were backed up from. The cmdlet will find files and folders backed up from this server. Accepts the `CHost` object. To get this object, run the `Get-VBRServer` cmdlet.	`CHost`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRTapeCatalogItem object that defines the tape catalog item (file, folder) with the following attributes: Name, Id, HostId, Path, IsDirectory, Size, CreationTime, LastWriteTime.

Examples

Find-VBRTapeCatalogItem Example 1. Finding Files and Folders Backed-Up from Certain Server

This example shows how to find files and folders backed-up from the certain server.

$server = Get-VBRServer -Name "Repo 01"

Find-VBRTapeCatalogItem -Server $server

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify Name parameter value. Save the result to the $server variable.
Run the Find-VBRTapeCatalogItem cmdlet. Set the $server variable as the Server parameter value.

Find-VBRTapeCatalogItem Example 2. Finding Certain File Backed-Up by Tape Job

This example shows how to find a certain file in the Reports folder backed-up by the tape job.

$item = Find-VBRTapeCatalogItem -Name "Reports"

Find-VBRTapeCatalogItem -CatalogItem $item

Perform the following steps:

Run the Find-VBRTapeCatalogItem cmdlet. Specify the Name parameter value. Save the result to the $item variable.
Run the Find-VBRTapeCatalogItem cmdlet. Set the $item variable as the CatalogItem parameter value.

Get-VBRServer