Freigeben über

Get-SCVirtualHardDisk

  • Referenz
Modul:
VirtualMachineManager

Ruft virtuelle Festplattenobjekte aus 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 aus einem virtuellen Computer, einer Vorlage oder als eigenständige Datei ab, die in der Virtual Machine Manager -Bibliothek (VMM) gespeichert ist.

Eine virtuelle Festplatte kann eine Windows-basierte VHD-Datei, eine Citrix XenServer-basierte VHD-Datei oder eine VMware-basierte.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 dann das Objekt in der $VHD Variablen.

Beispiel 2: Abrufen eines virtuellen Festplattenobjekts aus 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 verbindet sich mit VMMServer01.

Der zweite Befehl ruft das virtuelle Computerobjekt "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 Variable.

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 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 virtuellen Datenträgerlaufwerkobjekte unabhängig von dem virtuellen Computerobjekt oder vorlagenobjekt ab, 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 Gleichwertigkeit 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 Auftrag 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. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag 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 Releasewert für jede Ressource, die in die Bibliothek importiert wurde. 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 mithilfe des Cmdlets "Get-SCVirtualMachine " oder dem Cmdlet "Get-SCVMTemplate " abgerufen werden kann.