Get-SCVirtualDiskDrive
Ruft virtuelle Festplattenlaufwerke in einer Vorlage für virtuelle Maschinen oder auf einer virtuellen Maschine ab.
Syntax
All
Get-SCVirtualDiskDrive
[-VMMServer <ServerConnection>]
[-All]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VM
Get-SCVirtualDiskDrive
-VM <VM>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Template
Get-SCVirtualDiskDrive
-VMTemplate <Template>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
ID
Get-SCVirtualDiskDrive
[-ID] <Guid>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Get-SCVirtualDiskDrive werden virtuelle Laufwerksobjekte von Virtual Machine Manager (VMM) abgerufen. Diese virtuellen Festplattenlaufwerke können auf Vorlagen für virtuelle Maschinen konfiguriert werden, die in der Bibliothek gespeichert sind, oder auf virtuellen Maschinen, die entweder auf einem Host bereitgestellt oder in der Bibliothek gespeichert sind.
Beispiele
Beispiel 1: Abrufen aller virtuellen Datenträger in der VMM-Umgebung
PS C:\> Get-SCVirtualDiskDrive -VMMServer "VMMServer01.Contoso.com" -All
Mit diesem Befehl werden alle virtuellen Datenträger abgerufen, die an alle virtuellen Maschinen gebunden sind, die bei VMM auf VMMServer01 registriert sind. Der Befehl zeigt Informationen zu jedem virtuellen Laufwerk an.
Beispiel 2: Abrufen von virtuellen Laufwerken 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
Mit dem ersten Befehl wird das VM-Objekt mit dem Namen VM02 mithilfe des Cmdlets Get-SCVirtualMachine abgerufen. Der Befehl speichert dieses Objekt in der Variablen $VM.
Der zweite Befehl ruft alle Objekte des virtuellen Laufwerks auf VM02 ab und speichert diese Objekte in $VirtDiskDrive. Wenn, wie in diesem Beispiel angenommen, ein virtueller Computer mehrere virtuelle Festplattenlaufwerke enthält, ist mit jedem virtuellen Laufwerk entweder eine virtuelle Festplatte oder ein Pass-Through-Laufwerk verbunden.
Mit dem letzten Befehl werden die Eigenschaften der einzelnen virtuellen Laufwerke auf VM02 angezeigt. Zu diesen Informationen gehören der Name aller virtuellen Festplatten und der Pfad des physischen Laufwerks auf dem Host für alle Pass-Through-Festplatten.
Beispiel 3: Zählen von virtuellen Festplattenlaufwerken, mit Ausnahme von Pass-Through-Festplatten
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
Mit dem ersten Befehl werden die Objekte des virtuellen Laufwerks abgerufen, mit Ausnahme von Pass-Through-Datenträgern, die mit dem zweiten Steckplatz eines der IDE-Kanäle verbunden sind. Durch die Verwendung des @-Symbols und der Klammern 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 Objekte des virtuellen Laufwerks an, die den Filterkriterien entsprechen.
Beispiel 4: Abrufen von virtuellen Festplattenlaufwerken für alle Vorlagen für virtuelle Maschinen
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 Maschinen ab und speichert diese Objekte dann im $Templates Array.
Der zweite Befehl übergibt jedes in $Templates gespeicherte Vorlagenobjekt für virtuelle Computer an das Cmdlet ForEach-Object. Mit diesem Cmdlet werden alle Laufwerksobjekte für jede Vorlage abgerufen. Anschließend wählt der Befehl nur die Objekte des virtuellen Laufwerks aus, die einen IDE-Bustyp verwenden, und übergibt diese Objekte an das Cmdlet Format-List, das den Namen, den Bustyp, den Bus und die LUN für jedes Objekt des virtuellen Laufwerks anzeigt.
Parameter
-All
Gibt an, dass dieses Cmdlet eine vollständige Liste aller Objekte des virtuellen Laufwerks unabhängig vom übergeordneten Objekt abruft.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
All
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ID
Gibt die eindeutige ID des virtuellen Laufwerks an, das dieses Cmdlet abruft.
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ID
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.
Parametereigenschaften
| Typ: | UserRole |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VM
Gibt ein VM-Objekt an, von dem dieses Cmdlet virtuelle Laufwerke abruft.
Parametereigenschaften
| Typ: | VM |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
VM
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
Parametereigenschaften
| Typ: | ServerConnection |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMTemplate
Gibt ein VMM-Vorlagenobjekt an, das zum Erstellen virtueller Computer verwendet wird, die virtuelle Datenträgerlaufwerke enthalten, die mit diesem Cmdlet abgerufen werden.
Parametereigenschaften
| Typ: | Template |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Schablone |
Parametersätze
Template
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben
VirtualDiskDrive
Dieses Cmdlet gibt ein VirtualDiskDrive-Objekt zurück.
Hinweise
- Für dieses Cmdlet ist ein VMM-Vorlagenobjekt für virtuelle Maschinen oder ein VM-Objekt erforderlich, die mit dem Cmdlet Get-SCVMTemplate oder dem Cmdlet Get-SCVirtualMachine abgerufen werden können.