Share via

Get-SCVirtualDiskDrive

  • Referenz
Modul:
VirtualMachineManager

Ruft virtuelle Datenträgerlaufwerke auf einer Vorlage für virtuelle Computer oder auf einem virtuellen Computer ab.

Syntax

Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCVirtualDiskDrive ruft virtuelle Datenträgerlaufwerkobjekte (Virtual Machine Manager, VMM) ab. Diese virtuellen Datenträgerlaufwerke können auf virtuellen Computervorlagen konfiguriert werden, die in der Bibliothek gespeichert sind, oder auf virtuellen Computern, die auf einem Host oder in der Bibliothek gespeichert sind.

Beispiele

Beispiel 1: Abrufen aller virtuellen Datenträgerlaufwerke in Ihrer VMM-Umgebung

PS C:\> Get-SCVirtualDiskDrive -VMMServer "VMMServer01.Contoso.com" -All

Dieser Befehl ruft alle virtuellen Datenträgerlaufwerke ab, die an alle virtuellen Computer gebunden sind, die für VMM auf VMMServer01 registriert sind. Der Befehl zeigt Informationen zu jedem virtuellen Datenträgerlaufwerk an.

Beispiel 2: Abrufen virtueller Datenträgerlaufwerke für einen virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object {$_.Name -Eq "VM02"} 
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> $VirtDiskDrive

Der erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM02 mithilfe des Cmdlets Get-SCVirtualMachine ab. Der Befehl speichert dieses Objekt in der $VM Variablen.

Der zweite Befehl ruft alle virtuellen Datenträgerlaufwerkobjekte auf VM02 ab und speichert diese Objekte in $VirtDiskDrive. Wenn, wie in diesem Beispiel angenommen, eine virtuelle Maschine mehrere virtuelle Laufwerke enthält, ist mit jedem virtuellen Laufwerk eine virtuelle Festplatte oder ein Pass-Through-Datenträger verbunden.

Der letzte Befehl zeigt die Eigenschaften jedes virtuellen Datenträgerlaufwerks auf VM02 an. Diese Informationen umfassen den Namen aller virtuellen Festplatten und den Pfad des physischen Laufwerks auf dem Host für alle Pass-Through-Datenträger.

Beispiel 3: Zählen virtueller Datenträgerlaufwerke mit Ausnahme von Pass-Through-Datenträgern

PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -All | Where-Object {$_.BusType -Eq "IDE" -And $_.PassThroughDisk -Eq $Null -And $_.LUN -Eq 1 -And ($_.Bus -Eq 0 -Or $_.Bus -Eq 1)})
PS C:\> $VirtDiskDrive.Count

Der erste Befehl ruft die objekte des virtuellen Datenträgerlaufwerks ab, ausgenommen Pass-Through-Datenträger, die mit dem zweiten Steckplatz eines beiden IDE-Kanals verbunden sind. Wenn Sie das @-Symbol und die Klammern verwenden, wird sichergestellt, dass der Befehl die Ergebnisse in einem Array speichert, auch wenn der Befehl ein einzelnes Objekt oder einen $Null Wert zurückgibt.

Der zweite Befehl zeigt die Anzahl der Virtuellen Datenträgerlaufwerkobjekte an, die den Filterkriterien entsprechen.

Beispiel 4: Abrufen virtueller Datenträgerlaufwerke für alle Vorlagen für virtuelle Computer

PS C:\> $Templates = @(Get-SCVMTemplate)
PS C:\> $Templates | ForEach-Object {Get-SCVirtualDiskDrive -Template $_ | Where-Object {$_.BusType -Eq "IDE"}} | Format-List Name,BusType,Bus,LUN

Der erste Befehl ruft alle Vorlagen für virtuelle Computer ab, und speichert diese Objekte dann im $Templates-Array.

Der zweite Befehl übergibt jedes in $Templates gespeicherte virtuelle Computervorlagenobjekt an das Cmdlet ForEach-Object. Dieses Cmdlet ruft alle Datenträgerlaufwerkobjekte für jede Vorlage ab. Anschließend wählt der Befehl nur die virtuellen Datenträgerlaufwerkobjekte aus, die einen IDE-Bustyp verwenden, und übergibt diese Objekte an das Cmdlet Format-List, das den Namen, den Bustyp, den Bustyp, den Bus und die LUN für jedes objekt des virtuellen Datenträgers anzeigt.

Parameter

-All

Gibt an, dass dieses Cmdlet eine vollständige Liste aller virtuellen Datenträgerlaufwerkobjekte abruft, die unabhängig vom übergeordneten Objekt sind.

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

-ID

Gibt die eindeutige ID des virtuellen Datenträgerlaufwerks an, das dieses Cmdlet abruft.

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-VM

Gibt ein Virtuelles Computerobjekt an, aus dem dieses Cmdlet virtuelle Datenträgerlaufwerke abruft.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMTemplate

Gibt ein VMM-Vorlagenobjekt an, das zum Erstellen virtueller Computer verwendet wird, die virtuelle Datenträgerlaufwerke enthalten, die dieses Cmdlet abruft.

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

Ausgaben

VirtualDiskDrive

Dieses Cmdlet gibt ein VirtualDiskDrive-Objekt zurück.

Hinweise

  • Dieses Cmdlet erfordert ein VMM-Vorlagenobjekt oder ein virtuelles Computerobjekt, das mithilfe des Cmdlets "Get-SCVMTemplate " oder mit dem Cmdlet "Get-SCVirtualMachine " abgerufen werden kann.