Udostępnij za pośrednictwem

Get-SCVirtualHardDisk

  • Odwołanie
Moduł:
VirtualMachineManager

Pobiera obiekty wirtualnego dysku twardego z maszyny wirtualnej, z szablonu lub jako plik autonomiczny przechowywany w bibliotece programu VMM.

Składnia

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

Opis

Polecenie cmdlet Get-SCVirtualHardDisk pobiera obiekty wirtualnego dysku twardego z maszyny wirtualnej, szablonu lub jako plik autonomiczny przechowywany w bibliotece programu Virtual Machine Manager (VMM).

Wirtualny dysk twardy może być plikiem vhd opartym na systemie Windows, plikiem vhd opartym na programie Citrix XenServer lub plikiem VMware-based.vmdk. Wirtualny dysk twardy może być przechowywany jako obiekt autonomiczny w bibliotece programu VMM, dołączony do dysku wirtualnego na szablonie lub dołączony do dysku wirtualnego na wdrożonej lub przechowywanej maszynie wirtualnej.

Przykłady

Przykład 1. Pobieranie wirtualnego obiektu dysku twardego z biblioteki

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

To polecenie pobiera wirtualny obiekt dysku twardego o nazwie VHD01.vhd przechowywany w biblioteceServer01, a następnie zapisuje obiekt w zmiennej $VHD.

Przykład 2. Pobieranie wirtualnego obiektu dysku twardego z maszyny wirtualnej

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

Pierwsze polecenie łączy się z serwerem VMMServer01.

Drugie polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01, wybiera wszystkie wirtualne dyski twarde na maszynie VM01, której nazwa zawiera ciąg "DataDisk", a następnie przechowuje zwrócone obiekty wirtualnych dysków twardych w zmiennej $VHD.

Przykład 3. Pobieranie wirtualnego obiektu dysku twardego z określonego szablonu

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

To polecenie pobiera obiekt szablonu o nazwie Template01 z biblioteki i wyświetla wszystkie obiekty wirtualnego dysku twardego w tym szablonie.

Parametry

-All

Wskazuje, że to polecenie cmdlet pobiera wszystkie obiekty podrzędne niezależnie od obiektu nadrzędnego. Na przykład polecenie Get-SCVirtualDiskDrive -All pobiera wszystkie obiekty dysków wirtualnych niezależnie od obiektu maszyny wirtualnej lub obiektu szablonu, z którymi jest skojarzony każdy obiekt dysku wirtualnego.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FamilyName

Określa nazwę rodziny zasobu fizycznego w bibliotece programu VMM. Ta wartość jest używana w połączeniu z wersją, przestrzenią nazw i typem w celu ustanowienia równoważności między zasobami biblioteki.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ID

Określa identyfikator liczbowy jako globalnie unikatowy identyfikator lub identyfikator GUID dla określonego obiektu.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę obiektu programu VMM.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole. To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

Typ:UserRole
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Release

Określa ciąg opisujący wydanie zasobu biblioteki. Program VMM automatycznie tworzy wartość wydania dla każdego zasobu zaimportowanego do biblioteki. Po zaimportowaniu zasobu można dostosować ciąg.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VM

Określa obiekt maszyny wirtualnej.

Typ:VM
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMMServer

Określa obiekt serwera programu VMM.

Typ:ServerConnection
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMTemplate

Określa obiekt szablonu programu VMM używany do tworzenia maszyn wirtualnych.

Typ:Template
Aliasy:Template
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

VirtualHardDisk

To polecenie cmdlet zwraca obiekt VirtualHardDisk.

Uwagi

  • Wymaga obiektu maszyny wirtualnej programu VMM lub obiektu szablonu programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCVirtualMachine lub polecenia cmdlet Get-SCVMTemplate.