Get-SCDirectoryChildItem

Ruft alle Dateien und Unterverzeichnisse im angegebenen Verzeichnis auf einem virtuellen Computerhost oder auf einem von VMM verwalteten Bibliotheksserver ab.

Syntax

Get-SCDirectoryChildItem
   -VMHost <Host>
   -Path <String>
   [<CommonParameters>]
Get-SCDirectoryChildItem
   -LibraryServer <LibraryServer>
   -Path <String>
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCDirectoryChildItem ruft alle Dateien und Unterverzeichnisse sofort unter dem angegebenen Verzeichnis auf einem virtuellen Computerhost oder auf einem Bibliotheksserver ab, der von Virtual Machine Manager (VMM) verwaltet wird. Wenn Sie einen Freigabepfad (z. B. \ServerName\ShareName\Directory\FileName) angeben, werden die Unterverzeichnisse des Freigabepfads zurückgegeben.

Wenn Sie das Cmdlet Get-SCDirectoryChildItem verwenden, um Dateien und Unterverzeichnisse auf einem Bibliotheksserver abzurufen, müssen Sie einen Pfad zu einer gültigen Bibliotheksfreigabe angeben. Beispielsweise ist der Freigabepfad zur standardmäßigen Bibliotheksfreigabe, die von Setup installiert wurde, wenn Sie zuerst VMM installieren: \VMMServerName.DomainName.com\MSSCVMMLibrary

Beispiele

Beispiel 1: Abrufen der Dateien und Unterverzeichnisse für den angegebenen Pfad auf einem VMM-Host

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Get-SCDirectoryChildItem -VMHost $VMHost -Path "C:\"

Der erste Befehl ruft das Hostobjekt namens VMHost01 aus der VMM-Datenbank ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl zeigt den Namen und andere Informationen zu jeder Datei und einem Unterverzeichnis direkt unter C:\ an. Laufwerk auf VMHost01.

Beispiel 2: Abrufen der Unterverzeichnisse für den angegebenen Pfad auf einem Bibliotheksserver

PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" -ComputerName "FileServer01.Contoso.com"
PS C:\> Get-SCDirectoryChildItem -LibraryServer $LibServ -Path "\\FileServer01.Contoso.com\MSSCVMMLibrary"

Der erste Befehl ruft das Bibliotheksserverobjekt namens FileServer01 von VMMServer01 ab und speichert das Objekt in der $LibServ Variablen.

Der zweite Befehl zeigt den Namen, das übergeordnete Verzeichnis und andere Informationen zu jeder Datei an, die im Verzeichnis für die Standardbibliotheksfreigabe auf FileServer01 gespeichert ist. Sie müssen den vollständigen Pfad zur Bibliotheksfreigabe angeben.

Hinweis: In diesem Beispiel wird davon ausgegangen, dass die Standardfreigabe der VMM-Bibliothek (MSSCVMMLibrary) in Ihrer Umgebung verwendet wird. Geben Sie zum Abrufen der Namen von Bibliotheksfreigaben den Typ Get-SCLibraryShare | Select Name.

Parameter

-LibraryServer

Gibt ein VMM-Bibliothekserverobjekt an.

Type:LibraryServer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Gibt den Zielpfad für den Vorgang an.

Beispiele für das Format:

  • Lokaler Pfad: -Path "F:\"
  • UNC-Pfad: -Path "\\Library\Templates"
  • Volume-GUID-Pfad: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX-Pfad: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Citrix XenServer-Pfad: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"

Dieser Parameter akzeptiert Wildcardzeichen für einen UNC-Pfad.

Beispiel für das Format:

UNC-Pfad: -Path "\\VMHostServer\MyVMs\*VM*"

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHost

Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im Add-SCVMHost-Cmdlet .

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Ausgaben

VMHostFileInformation

Dieses Cmdlet gibt ein VMHostFileInformation-Objekt zurück.