Sdílet prostřednictvím

Get-SCVirtualHardDisk

  • Reference
Modul:
VirtualMachineManager

Získá objekty virtuálního pevného disku z virtuálního počítače, ze šablony nebo jako samostatný soubor uložený v knihovně VMM.

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

Description

Rutina Get-SCVirtualHardDisk získá objekty virtuálního pevného disku z virtuálního počítače, ze šablony nebo jako samostatný soubor uložený v knihovně nástroje Virtual Machine Manager (VMM).

Virtuální pevný disk může být soubor .vhd založený na Windows, soubor .vhd založený na Citrix XenServeru nebo soubor VMware-based.vmdk. Virtuální pevný disk může být uložený jako samostatný objekt v knihovně VMM, připojený k virtuální diskové jednotce v šabloně nebo připojený k virtuální diskové jednotce na nasazeném nebo uloženém virtuálním počítači.

Příklady

Příklad 1: Získání objektu virtuálního pevného disku z knihovny

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

Tento příkaz získá objekt virtuálního pevného disku s názvem VHD01.vhd uložený na LibraryServer01 a pak uloží objekt do proměnné $VHD.

Příklad 2: Získání objektu virtuálního pevného disku z virtuálního počítače

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

První příkaz se připojí k VMMServer01.

Druhý příkaz získá objekt virtuálního počítače s názvem VM01, vybere všechny virtuální pevné disky na virtuálním počítači VM01, jehož název obsahuje řetězec DataDisk, a pak uloží vrácené objekty virtuálního pevného disku do proměnné $VHD.

Příklad 3: Získání objektu virtuálního pevného disku z konkrétní šablony

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

Tento příkaz získá objekt šablony s názvem Template01 z knihovny a zobrazí všechny objekty virtuálního pevného disku v této šabloně.

Parametry

-All

Označuje, že tato rutina získá všechny podřízené objekty nezávislé na nadřazeného objektu. Příkaz například Get-SCVirtualDiskDrive -All získá všechny objekty virtuální diskové jednotky bez ohledu na objekt virtuálního počítače nebo objekt šablony, ke kterému je přidružený každý objekt jednotky virtuálního disku.

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

-FamilyName

Určuje název rodiny fyzického prostředku v knihovně VMM. Tato hodnota se používá ve spojení s verzí, oborem názvů a typem k navázání ekvivalence mezi prostředky knihovny.

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

-ID

Určuje číselný identifikátor jako globálně jedinečný identifikátor nebo identifikátor GUID konkrétního objektu.

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

-Name

Určuje název objektu VMM.

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

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

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

-OnBehalfOfUserRole

Určuje roli uživatele. K získání role uživatele použijte rutinu Get-SCUserRole . Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

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

-Release

Určuje řetězec, který popisuje vydání prostředku knihovny. Nástroj VMM automaticky vytvoří hodnotu vydané verze pro každý prostředek importovaný do knihovny. Po importu prostředku je možné řetězec přizpůsobit.

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

-VM

Určuje objekt virtuálního počítače.

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

-VMMServer

Určuje objekt serveru VMM.

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

-VMTemplate

Určuje objekt šablony VMM použitý k vytvoření virtuálních počítačů.

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

Výstupy

VirtualHardDisk

Tato rutina vrátí objekt VirtualHardDisk .

Poznámky

  • Vyžaduje objekt virtuálního počítače VMM nebo objekt šablony VMM, který lze načíst pomocí rutiny Get-SCVirtualMachine nebo Rutiny Get-SCVMTemplate .