Delen via

Get-SCVirtualHardDisk

  • Referentie
Module:
VirtualMachineManager

Hiermee haalt u virtuele hardeschijfobjecten op van een virtuele machine, van een sjabloon of als een zelfstandig bestand dat is opgeslagen in de VMM-bibliotheek.

Syntaxis

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>]

Description

De Get-SCVirtualHardDisk cmdlet haalt virtuele hardeschijfobjecten op van een virtuele machine, van een sjabloon of als een zelfstandig bestand dat is opgeslagen in de VMM-bibliotheek (Virtual Machine Manager).

Een virtuele harde schijf kan een .vhd-bestand op basis van Windows, een .vhd-bestand op basis van Citrix XenServer of een VMware-gebaseerd.vmdk-bestand zijn. Een virtuele harde schijf kan worden opgeslagen als een zelfstandig object in de VMM-bibliotheek, gekoppeld aan een virtuele schijfstation op een sjabloon of gekoppeld aan een virtuele schijfstation op een geïmplementeerde of opgeslagen virtuele machine.

Voorbeelden

Voorbeeld 1: Een virtueel hardeschijfobject ophalen uit de bibliotheek

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

Met deze opdracht wordt het virtuele hardeschijfobject met de naam VHD01.vhd opgeslagen op LibraryServer01 opgehaald en wordt het object vervolgens opgeslagen in de variabele $VHD.

Voorbeeld 2: Een virtueel hardeschijfobject ophalen van een virtuele machine

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

De eerste opdracht maakt verbinding met VMMServer01.

Met de tweede opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald, worden alle virtuele harde schijven op VM01 geselecteerd waarvan de naam de tekenreeks 'DataDisk' bevat en slaat u vervolgens de geretourneerde virtuele hardeschijfobjecten op in de $VHD variabele.

Voorbeeld 3: Een virtueel hardeschijfobject ophalen uit een specifieke sjabloon

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

Met deze opdracht wordt het sjabloonobject met de naam Template01 opgehaald uit de bibliotheek en worden alle virtuele hardeschijfobjecten op die sjabloon weergegeven.

Parameters

-All

Geeft aan dat met deze cmdlet alle onderliggende objecten onafhankelijk van het bovenliggende object worden opgehaald. Met de opdracht Get-SCVirtualDiskDrive -All bijvoorbeeld alle virtuele-schijfstationobjecten ophaalt, ongeacht het virtuele-machineobject of sjabloonobject waaraan elk object van het virtuele schijfstation is gekoppeld.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FamilyName

Hiermee geeft u een familienaam op voor een fysieke resource in de VMM-bibliotheek. Deze waarde wordt gebruikt in combinatie met Release, Naamruimte en Type om gelijkwaardigheid tussen bibliotheekbronnen tot stand te brengen.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ID

Hiermee geeft u de numerieke id op als een globaal unieke id of GUID voor een specifiek object.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Release

Hiermee geeft u een tekenreeks op die de release van een bibliotheekresource beschrijft. VMM maakt automatisch een releasewaarde voor elke resource die in de bibliotheek is geïmporteerd. Nadat de resource is geïmporteerd, kan de tekenreeks worden aangepast.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VM

Hiermee geeft u een virtuele-machineobject.

Type:VM
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMTemplate

Hiermee geeft u een VMM-sjabloonobject op dat wordt gebruikt om virtuele machines te maken.

Type:Template
Aliassen:Template
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

VirtualHardDisk

Met deze cmdlet wordt een VirtualHardDisk--object geretourneerd.

Notities

  • Hiervoor is een VMM-vm-object of een VMM-sjabloonobject vereist, dat kan worden opgehaald met behulp van de cmdlet Get-SCVirtualMachine of de cmdlet Get-SCVMTemplate.