This is an archive version of the document. To get the most up-to-date information, see the current version.

Find-VBRViFolder

In this article

    Short Description

    Looks for folders on a specified ESX(i) host.

    Applies to

    Platform: VMware

    Product Edition: Standard, Enterprise, Enterprise Plus

    Syntax

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

    Related Commands

    Get-VBRServer

    Detailed Description

    This cmdlet returns folders on a specified ESX(i) host.

    You can get the list of all folders on the specified ESX(i) host or look for instances directly by name.

    Return Type

    CViFolderItem

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Server

    Specifies the ESX(i) host on which you want to look for folders.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    False

    Name

    Specifies the name of the folder you want to get, or search conditions.

    You can specify multiple names separated by commas.

    False

    Named

    False

    True

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

    Example 1

    This command looks for all folders located on the ESXi host named 'Server01'. The server is obtained with Get-VBRServer, sorted by name and piped down.

    Get-VBRServer -Name "Server01" | Find-VBRViFolder

    Example 2

    This command looks for a folder named 'Weekly_Reports' located on the ESXi host named 'Server01'. The server is obtained with Get-VBRServer, sorted by name and piped down.

    Get-VBRServer -Name "Server01" | Find-VBRViFolder -Name "Weekly_Reports"

    Example 3

    This command looks for folders named 'Weekly_Reports' and 'Monthly_Reports' located on the ESXi host named "Server01". The server is obtained with Get-VBRServer and assigned to '$server01' variable.

    PS C:\PS> $server01 = Get-VBRServer -Name "Server01"

    PS C:\PS> Find-VBRViFolder -Server $server01 -Name "Weekly_Reports", "Monthly_Reports"