Get-Folder

VMware: Retrieves folders available on a vCenter Server system

Script

#Requires -Version 5.1
#Requires -Modules VMware.VimAutomation.Core
[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [string]$VIServer,
    [Parameter(Mandatory = $true)]
    [pscredential]$VICredential,
    [string]$FolderName = '*',
    [string]$LocationName,
    [ValidateSet("All", "VM", "HostAndCluster", "Datastore", "Network", "Datacenter")]
    [string]$LocationType,
    [switch]$NoRecursion
)
Process {
    try {
        $vmServer = Connect-VIServer -Server $VIServer -Credential $VICredential -ErrorAction Stop
        $cmdArgs = @{ ErrorAction = 'Stop'; Server = $vmServer }
        if (-not [System.String]::IsNullOrWhiteSpace($LocationName)) {
            $location = Get-Folder @cmdArgs -Name $LocationName -ErrorAction Stop
            if ($null -eq $location) { throw "Location $LocationName not found" }
            $cmdArgs.Add('Location', $location)
        }
        $cmdArgs.Add('Name', $FolderName)
        if ($NoRecursion) { $cmdArgs.Add('NoRecursion', $true) }
        if (-not [System.String]::IsNullOrWhiteSpace($LocationType) -and $LocationType -ne 'All') { $cmdArgs.Add('Type', $LocationType) }
        $result = Get-Folder @cmdArgs -ErrorAction Stop | Select-Object *
        if ($null -ne $result) { foreach ($item in $result) { $item | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format "yyyy-MM-dd HH:mm:ss") -PassThru -Force } }
    }
    catch { throw }
    finally { if ($null -ne $vmServer) { Disconnect-VIServer -Server $vmServer -Force -Confirm:$false -ErrorAction SilentlyContinue } }
}

Customize

VIServer string

IP address or DNS name of the vSphere server

VICredential pscredential

PSCredential object for authenticating with the server

FolderName string

Name of the folder to retrieve; retrieves all if empty

LocationName string

Container object where to retrieve the folder

LocationType string

Type of the container object (All, VM, HostAndCluster, Datastore, Network, Datacenter)

NoRecursion switch

Off

Disable the recursive behavior of the command