Freigeben über


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.