Find-VBRViFolder

Short Description

Looks for folders on a specified ESXi host.

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

Syntax

Find-VBRViFolder [-Name <String[]>] -Server <CHost> [<CommonParameters>]

Detailed Description

This cmdlet returns folders on a specified ESXi host.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Name	Specifies an array of folder names. The cmdlet will return folders with these names.	`String[]`	False	Named	False
Server	Specifies an ESXi host on which you want to look for folders. Accepts the `CHost` object. To get this object, run the `Get-VBRServer` cmdlet.	`CHost`	True	Named	True (ByPropertyName, ByValue)

<CommonParameters>

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

Output Object

The cmdlet returns the CViFolderItem object that contains folders on a specified ESXi host.

Examples

Find-VBRViFolder Example 1. Looking for all Folders Located on ESXi Host

This example shows how to look for all folders located on the Server01 ESXi host.

$server = Get-VBRServer -Type ESXi -Name "Server01"

Find-VBRViFolder -Server $server

Perform the following steps:

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

Find-VBRViFolder Example 2. Looking for Specific Folder Located on ESXi Host

This example shows how to look for the Weekly_Reports folder located on the Server01 ESXi host.

$server = Get-VBRServer -Type ESXi -Name "Server01"

Find-VBRViFolder -Server $server -Name "Weekly_Reports"

Perform the following steps:

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

Find-VBRViFolder Example 3. Looking for Several Specific Folders Located on ESXi Host

This example shows how to look for the Weekly_Reports and Monthly_Report folders located on the Server01 ESXi host.

$server01 = Get-VBRServer -Name "Server01"

Find-VBRViFolder -Server $server01 -Name "Weekly_Reports", "Monthly_Reports"

Perform the following steps:

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