Udostępnij za pośrednictwem

Set-SCVirtualHardDisk

  • Odwołanie
Moduł:
VirtualMachineManager

Zmienia właściwości wirtualnego obiektu dysku twardego używanego w programie VMM.

Składnia

Set-SCVirtualHardDisk
   [-OperatingSystem <OperatingSystem>]
   [-VirtualizationPlatform <VirtualizationPlatform>]
   [-Tag <System.Collections.Generic.List`1[System.String]>]
   [-ProductKey <String>]
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisk] <VirtualHardDisk>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Opis

Polecenie cmdlet set-SCVirtualHardDisk zmienia co najmniej jedną właściwość obiektu wirtualnego dysku twardego używanego w środowisku programu Virtual Machine Manager (VMM). Plik wirtualnego dysku twardego używany w programie VMM to plik vhd oparty na systemie Windows, plik vhd oparty na programie Citrix XenServer lub plik vmdk oparty na oprogramowaniu VMware.

Właściwości, które można zmienić, obejmują:

  • Opis
  • Włączone
  • Nazwa
  • System operacyjny
  • Właściciel
  • SharePath

Plik wirtualnego dysku twardego może być przechowywany w bibliotece programu VMM lub może być dołączony do dysku wirtualnego na maszynie wirtualnej lub szablonie.

Aby zmienić ustawienia magistrali i jednostki LUN dla dysku wirtualnego, użyj polecenia cmdlet Set-SCVirtualDiskDrive.

Przykłady

Przykład 1. Zmiana opisu wirtualnego dysku twardego

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"

Pierwsze polecenie pobiera obiekt wirtualnego dysku twardego o nazwie "WindowsServer2003BootVHD.vhd" z biblioteki na serwerze VMMServer01, a następnie przechowuje obiekt w zmiennej $VHD.

Drugie polecenie zmienia opis obiektu wirtualnego dysku twardego przechowywanego w $VHD na "Najnowszy dysk VHD rozruchu systemu Windows Server 2008 R2".

Przykład 2: Włączanie wirtualnego dysku twardego opartego na oprogramowaniu VMware w bibliotece

PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE

Pierwsze polecenie pobiera obiekt wirtualnego dysku twardego o nazwie WindowsServer2008.vmdk, a następnie zapisuje obiekt wirtualnego dysku twardego w zmiennej $VMDK.

Drugie polecenie wyłącza wirtualny obiekt dysku twardego przechowywany w $VMDK.

Przykład 3: określ właściciela wszystkich wirtualnych dysków twardych z właścicielem "Nieznany"

PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"

To polecenie pobiera wszystkie obiekty wirtualnego dysku twardego z biblioteki programu VMM, której właściciel jest "Nieznany", a następnie określa właściciela dla każdego obiektu wirtualnego dysku twardego.

Parametry

-Description

Określa opis obiektu wirtualnego dysku twardego.

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

-Enabled

Włącza obiekt po ustawieniu wartości $True lub wyłącza obiekt w przypadku ustawienia wartości $False. Jeśli na przykład chcesz uaktualnić oprogramowanie na szablonie maszyny wirtualnej, możesz wyłączyć obiekt szablonu w bibliotece programu VMM, aby tymczasowo uniemożliwić użytkownikom korzystanie z tego obiektu.

Typ:Boolean
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

-JobGroup

Określa identyfikator serii poleceń, które będą uruchamiane jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.

Typ:String
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:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OperatingSystem

Określa typ systemu operacyjnego dla maszyny wirtualnej. Aby wyświetlić listę nazw wszystkich dostępnych systemów operacyjnych w programie VMM, wpisz Get-SCOperatingSystem.

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

-Owner

Określa właściciela obiektu programu VMM w postaci prawidłowego konta użytkownika domeny.

  • Przykładowy format: -Owner "Contoso\PattiFuller"
  • Przykładowy format: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProductKey

Określa klucz produktu. Klucz produktu to 25-cyfrowy numer identyfikujący licencję produktu. Klucz produktu może służyć do rejestrowania programu VMM lub systemu operacyjnego do zainstalowania na maszynie wirtualnej lub hoście.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

Typ:Guid
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:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-SharePath

Określa ścieżkę do prawidłowego udziału biblioteki na istniejącym serwerze biblioteki, który używa ścieżki Universal Naming Convention (UNC).

Przykładowy format: -SharePath "\\LibServer01\LibShare"

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

-Tag

Określa wyraz lub frazę do skojarzenia z obiektem, aby można było wyszukać wszystkie obiekty z określonym zestawem tagów. Możesz wyszukać podzbiór tagów lub wyszukać pełny zestaw tagów.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UserRole

Określa obiekt roli użytkownika.

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

-VirtualHardDisk

Określa obiekt wirtualnego dysku twardego.

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

-VirtualHardDisks

Określa tablicę wirtualnych obiektów dysku twardego.

Typ:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VirtualizationPlatform

Określa platformę wirtualizacji hosta maszyny wirtualnej zarządzanego przez program VMM. Dopuszczalne wartości tego parametru to:

  • HyperV
  • VMwareESX
  • XENServer
Typ:VirtualizationPlatform
Dopuszczalne wartości:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
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

Dane wyjściowe

VirtualHardDisk

To polecenie cmdlet zwraca obiekt VirtualHardDisk.

Uwagi

  • Wymaga obiektu wirtualnego dysku twardego programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCVirtualHardDisk.