Find-VBRViFolder

In this article

    Short Description

    Looks for folders on a specified ESXi host.

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

    Syntax

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

    Detailed Description

    This cmdlet returns folders on a specified ESXi host.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    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.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    Name

    Specifies an array of folder names. The cmdlet will return folders with these names.

    String[]

    False

    Named

    False

    Parameters

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    Return Type

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

    Find-VBRViFolderExample 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:

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

    Find-VBRViFolderExample 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:

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

    Find-VBRViFolderExample 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:

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

    Related Commands

    Get-VBRServer