Freigeben über

Get-SCVirtualHardDisk

  • Referenz
Modul:
VirtualMachineManager

Ruft virtuelle Festplattenobjekte von einem virtuellen Computer, aus einer Vorlage oder als eigenständige Datei ab, die in der VMM-Bibliothek gespeichert ist.

Syntax

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCVirtualHardDisk ruft virtuelle Festplattenobjekte von einem virtuellen Computer, aus einer Vorlage oder als eigenständige Datei ab, die in der VMM-Bibliothek (Virtual Machine Manager) gespeichert ist.

Eine virtuelle Festplatte kann eine windowsbasierte VHD-Datei, eine Citrix XenServer-basierte VHD-Datei oder eine VMware-based.vmdk-Datei sein. Eine virtuelle Festplatte kann als eigenständiges Objekt in der VMM-Bibliothek gespeichert werden, an ein virtuelles Datenträgerlaufwerk auf einer Vorlage angefügt oder an ein virtuelles Datenträgerlaufwerk auf einem bereitgestellten oder gespeicherten virtuellen Computer angefügt werden.

Beispiele

Beispiel 1: Abrufen eines virtuellen Festplattenobjekts aus der Bibliothek

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }

Dieser Befehl ruft das virtuelle Festplattenobjekt namens VHD01.vhd ab, das auf LibraryServer01 gespeichert ist, und speichert das Objekt dann in der $VHD Variablen.

Beispiel 2: Abrufen eines virtuellen Festplattenobjekts von einem virtuellen Computer

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }

Der erste Befehl stellt eine Verbindung mit VMMServer01 bereit.

Der zweite Befehl ruft das virtuelle Computerobjekt mit dem Namen VM01 ab, wählt alle virtuellen Festplatten auf VM01 aus, deren Name die Zeichenfolge "DataDisk" enthält, und speichert dann die zurückgegebenen virtuellen Festplattenobjekte in der $VHD Variablen.

Beispiel 3: Abrufen eines virtuellen Festplattenobjekts aus einer bestimmten Vorlage

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "Template01"} | Get-SCVirtualHardDisk

Dieser Befehl ruft das Vorlagenobjekt namens "Template01" aus der Bibliothek ab und zeigt alle virtuellen Festplattenobjekte in dieser Vorlage an.

Parameter

-All

Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft. Der Befehl Get-SCVirtualDiskDrive -All ruft beispielsweise alle Objekte des virtuellen Datenträgerlaufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes virtuelle Datenträgerlaufwerkobjekt zugeordnet ist.

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

-FamilyName

Gibt einen Familiennamen für eine physische Ressource in der VMM-Bibliothek an. Dieser Wert wird in Verbindung mit Release, Namespace und Type verwendet, um die Äquivalenz zwischen Bibliotheksressourcen herzustellen.

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

-ID

Gibt den numerischen Bezeichner als global eindeutigen Bezeichner oder GUID für ein bestimmtes Objekt an.

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

-Name

Gibt den Namen eines VMM-Objekts an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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

-Release

Gibt eine Zeichenfolge an, die die Veröffentlichung einer Bibliotheksressource beschreibt. VMM erstellt automatisch einen Freigabewert für jede Ressource, die in die Bibliothek importiert wird. Nachdem die Ressource importiert wurde, kann die Zeichenfolge angepasst werden.

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

-VM

Gibt ein Objekt virtueller Maschinen an.

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 zum Erstellen virtueller Maschinen verwendetes VMM-Vorlagenobjekt an.

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

Ausgaben

VirtualHardDisk

Dieses Cmdlet gibt ein VirtualHardDisk-Objekt zurück.

Hinweise

  • Erfordert ein virtuelles VMM-Computerobjekt oder ein VMM-Vorlagenobjekt, das mit dem Cmdlet Get-SCVirtualMachine oder dem Cmdlet Get-SCVMTemplate abgerufen werden kann.