Set-SCVirtualMachine

Reference

Modul:: VirtualMachineManager

Změní vlastnosti virtuálního počítače spravovaného nástrojem VMM.

Syntax

Set-SCVirtualMachine
   [-VM] <VM>
   [-VMwareResourcePool <VmwResourcePool>]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-RemoveSelfServiceUserRole <Boolean>]
   [-EnableOperatingSystemShutdown <Boolean>]
   [-EnableTimeSync <Boolean>]
   [-EnableDataExchange <Boolean>]
   [-EnableHeartbeat <Boolean>]
   [-EnableBackup <Boolean>]
   [-InstallVirtualizationGuestServices <Boolean>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-VMShieldingData <KeyFile>]
   [-RunAsSystem]
   [-RunAsUserCredential <PSCredential>]
   [-DelayStartSeconds <Int32>]
   [-UseHardwareAssistedVirtualization <Boolean>]
   [-Cloud <Cloud>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-RemoveFromCloud]
   [-ClusterNonPossibleOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-ClusterPreferredOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-UserRole <UserRole>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-QuotaPoint <UInt32>]
   [-CostCenter <String>]
   [-Tag <String>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-BlockDynamicOptimization <Boolean>]
   [-ClearDRProtection]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled <Boolean>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled <Boolean>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired <Boolean>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

Rutina Set-SCVirtualMachine změní vlastnosti virtuálního počítače spravovaného nástrojem Virtual Machine Manager (VMM).

Vlastnosti, které můžete změnit, zahrnují následující:

Přidružte virtuální počítač ke cloudu.
Název, vlastník a popis virtuálního počítače
Pořadí spuštění systému BIOS, pokud je virtuální počítač nasazený na hostiteli Hyper-V.
Množství prostředků na hostiteli používaném virtuálním počítačem Mezi ně patří:
Maximální množství prostředků procesoru hostitele, které může virtuální počítač používat.
Byl očekáváno použití procesoru hostitele virtuálním počítačem.
Množství prostředků procesoru hostitele používaného jedním virtuálním počítačem vzhledem k jiným virtuálním počítačům na stejném hostiteli.
Velikost paměti hostitele, kterou může virtuální počítač používat.
Velikost šířky pásma v síti hostitele, kterou může virtuální počítač používat.
Nastavení hardwaru pro virtuální počítač nesouvisející s hostitelskými prostředky Mezi ně patří:
Počet procesorů
Typ procesoru.
Počet vstupně-výstupních operací disku za sekundu (IOPS).
Omezení funkčnosti procesoru pro starší operační systém, například systém Windows NT 4.0.
Nákladové středisko, značka a vlastní nastavení, která se používají k filtrování virtuálních počítačů podle kritérií.
Nastavení, která umožňují různé volitelné možnosti, mezi které patří:
Povolení nebo zakázání objektu knihovny, aby byl dostupný nebo dočasně nedostupný uživatelům.
Povolení zálohování virtuálního počítače na hostiteli Hyper-V se službou Stínová kopie svazku
Povolení páru klíč/hodnota pro výměnu dat mezi virtuálním počítačem a jeho hostitelem Hyper-V
Povolení vypnutí virtuálního počítače z konzoly Hyper-V
Povolení synchronizace času mezi virtuálním počítačem a jejím hostitelem Hyper-V
Povolení hodnoty SYSTÉMU BIOS pro NumLock pro virtuální počítač na hostiteli Hyper-V
Nastavení určující, jestli je virtuální počítač vysoce dostupný, to znamená virtuální počítač, který se má nasadit na uzel hostitelského clusteru Hyper-V nebo hostitelského clusteru Citrix XenServer.
Nastavení určující, jestli jsou na virtuálním počítači nasazené na hostiteli Hyper-V nainstalované služby hosta virtualizace.
Počet sekund, které se mají zpozdit před spuštěním virtuálního počítače
Nastavení, které identifikuje operační systém, který se používá pro virtuální počítač.
Spuštění a zastavení akcí pro virtuální počítač
Nastavení, které omezuje počet samoobslužných uživatelů virtuálních počítačů, které můžou vytvářet.
Nastavení použité k přepnutí role, kterou samoobslužný uživatel, který patří do více rolí, používá ke správě virtuálního počítače.
Nastavení, které přiřadí virtuální počítač na hostiteli ESX fondu prostředků VMware.

Pokud chcete změnit vlastnosti virtuální disketové jednotky, virtuální jednotky DVD, virtuálního síťového adaptéru nebo virtuálního adaptéru SCSI přidruženého k určitému virtuálnímu počítači, použijte rutinu Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter nebo Set-SCVirtualScsiAdapter .

Příklady

Příklad 1: Určení velikosti paměti pro existující virtuální počítač

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> If($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -MemoryMB 1024

První příkaz získá objekt virtuálního počítače s názvem VM01 a pak tento objekt uloží do proměnné $VM.

Druhá určuje, jestli je virtuální počítač uložený v $VM ve vypnutém stavu. Pokud virtuální počítač není ve vypnutém stavu, použije příkaz Stop-SCVirtualMachine k vypnutí virtuálního počítače. Další informace o vypnutí virtuálního počítače zadejte Get-Help Stop-SCVirtualMachine.

Poslední příkaz změní paměť přidělenou virtuálnímu počítači VM01 na 1024 MB.

Příklad 2: Změna role uživatele použité ke správě virtuálního počítače pro uživatele, který patří do více rolí samoobslužných uživatelů

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" -Name "VM02"
PS C:\> $SSRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCVirtualMachine -VM $VM -UserRole $SSRole

První příkaz získá objekt virtuálního počítače s názvem VM02 z VMMServer01 a pak tento objekt uloží do proměnné $VM.

Druhý příkaz získá objekt role uživatele s názvem ContosoSelfServiceUsers a pak uloží objekt do proměnné $SSRole.

Poslední příkaz určuje, že členům role samoobslužného uživatele s názvem SSUserRole3 se teď udělí oprávnění ke správě virtuálního počítače s názvem VM02.

Poznámka: Nástroj VMM používá parametr UserRole k nastavení virtuálních počítačů spravovaných členy konkrétní role uživatele samoobslužné služby. K konfiguraci tohoto nastavení obvykle nemusíte použít rutinu Set-SCVirtualMachine s parametrem UserRole . Pokud je ale jeden nebo více uživatelů členy více rolí samoobslužných uživatelů a udělíte jim oprávnění ke správě více virtuálních počítačů na stejném hostiteli, můžete narazit na případ, kdy chcete přepnout roli uživatele, která má oprávnění ke správě konkrétního virtuálního počítače. Tento příklad znázorňuje tento scénář.

Příklad 3: Zakázání synchronizace času na virtuálním počítači používaném jako řadič domény

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "STOP"
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> trap{"Fail: Cannot disable Time Synchronization for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -EnableTimeSynchronization $TRUE | Out-Null
PS C:\> $ErrorActionPreference = $EAP

První příkaz uloží aktuální nastavení pro $ErrorActionPreference do proměnné $EAP. Tato proměnná se použije později k vrácení nastavení do původní hodnoty.

Druhý příkaz nastaví předvolbu akce na stop. Tato předvolba akce chyby změní chybu z neukončující chyby na ukončující chybu. Objekt chyby je vyvolán jako výjimka místo zápisu do výstupního kanálu a příkaz se nadále nespustí.

Třetí příkaz získá objekt virtuálního počítače s názvem VM03 a uloží ho do proměnné $VM.

Čtvrtý příkaz zakáže nastavení synchronizace času. Pro virtuální počítače, které fungují jako řadiče domény, se obvykle vyžaduje zakázání synchronizace času. Příkaz používá příkaz soutisku k zachycení ukončování výjimek. Pokud příkaz Set-SCVirtualMachine selže, zobrazí se řetězec v příkazu trap . Pokračovat se používá v příkazu soutisku , aby se místo ukončení pokračovalo. Rutina Out-Null přesměruje výstup na $Null místo odeslání do konzoly.

Poslední příkaz nastaví hodnotu $ErrorActionPreference na hodnotu uloženou v $EAP.

Příklad 4: Nastavení pořadí spuštění zařízení pro všechny virtuální počítače, které tuto funkci podporují

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "Stop"
PS C:\> $VMs = @(Get-SCVirtualMachine)
PS C:\> ForEach($VM in $VMs){trap{"Fail: Cannot set BIOS for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -BootOrder "PXEBoot","IDEHarddrive","CD","Floppy" | Out-Null}
PS C:\> $ErrorActionPreference = $EAP

První příkaz uloží aktuální nastavení pro $ErrorActionPreference v $EAP. Tato proměnná se použije později k vrácení nastavení do původní hodnoty.

Druhý příkaz nastaví předvolbu akce chyby na Zastavit. Tato předvolba akce chyby změní chybu z neukončující chyby na ukončující chybu. Objekt chyby je vyvolán jako výjimka místo zápisu do výstupního kanálu a příkaz se nadále nespustí.

Třetí příkaz získá každý objekt virtuálního počítače ukládá objekty do $VMs. Pomocí symbolu @ a závorek se ujistěte, že příkaz ukládá výsledky do pole v případě, že příkaz vrátí jeden objekt nebo hodnotu null.

Čtvrtý příkaz nastaví pořadí spouštění systému BIOS pro každý virtuální počítač na PXEBoot, IDEHarddrive, CD, Disketa. Příkaz používá příkaz soutisku k zachycení ukončování výjimek. Pokud příkaz Set-SCVirtualMachine selže, zobrazí se řetězec v příkazu trap. Pokračování se používá v příkazu trap k pokračování ve spuštění místo ukončení smyčky ForEach . Rutina Out-Null přesměruje výstup na $Null místo odeslání do konzoly.

Poznámka: Parametr BootOrder se používá pouze pro virtuální počítače na hostitelích Hyper-V a Citrix XenServer. Nepoužívá se pro virtuální počítače na hostitelích VMware ESX. Hostitelé systému XenServer nepodporují diskety, a proto ignoruje disketu, pokud je uvedena v pořadí spouštění.

Poslední příkaz nastaví hodnotu pro $ErrorActionPreference na hodnotu uloženou v protokolu EAP.

Další informace o standardním příkazu smyčky Windows PowerShell ForEach zadejte Get-Help about_ForEach.

Příklad 5: Určení vlastníka pro všechny virtuální počítače bez vlastníka

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

Tento příkaz získá všechny objekty virtuálních počítačů na VMMServer01, vybere pouze ty objekty virtuálního počítače, kde není uveden žádný vlastník, a určuje vlastníka pro každý virtuální počítač.

Příklad 6: Povolení dynamické paměti pro existující virtuální počítač

PS C:\> $VM = Get-SCVirtualMachine -Name "VM06"
PS C:\> if($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

První příkaz získá objekt virtuálního počítače VM06 a uloží ho do proměnné $VM. Pokud chcete na virtuálním počítači povolit dynamickou paměť, musí být virtuální počítač umístěn na hostiteli se systémem Windows Server 2008 R2 SP1 nebo novější verzí.

Druhý příkaz určuje, jestli je virtuální počítač uložený v $VM ve vypnutém stavu. Pokud virtuální počítač není ve vypnutém stavu, příkaz použije k vypnutí virtuálního počítače příkaz Stop-SCVirtualMachine .

Poslední příkaz povolí dynamickou paměť, nastaví spouštěcí paměť na 1024 MB a nastaví maximální paměť na 2048 MB. Spouštěcí paměť je množství paměti na hostiteli, který je přidělen virtuálnímu počítači VM06 při spuštění. Maximální paměť je maximální velikost paměti na hostiteli, který je přidělen virtuálnímu počítači VM06.

Parametry

-AutomaticCriticalErrorAction

Určuje akci, která se má provést, když se virtuální počítač setká s kritickou chybou a překročí dobu trvání časového limitu určenou parametrem AutomaticCriticalErrorActionTimeout . Přijatelné hodnoty pro tento parametr jsou: Pause a None.

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

-AutomaticCriticalErrorActionTimeout

Určuje dobu, po kterou se má v minutách čekat v kritickém pozastavení před vypnutím virtuálního počítače.

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

-AvailabilitySetNames

Určuje seznam názvů skupin dostupnosti.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlockDynamicOptimization

Označuje, jestli je dynamická optimalizace pro virtuální počítač blokovaná.

Type:	Boolean
Aliases:	ExcludeFromPRO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BootOrder

Určuje pořadí zařízení, která virtuální počítač na hostiteli Hyper-V používá ke spuštění. Platné hodnoty jsou:

CD
IDEHardDrive
PXEBoot
Diskety

Type:	BootDevice[]
Accepted values:	Floppy, CD, IdeHardDrive, PxeBoot, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CapabilityProfile

Určuje objekt profilu schopností.

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

-CheckpointType

Určuje typ kontrolního bodu. Tento parametr přijímá tyto hodnoty:

Zakázáno
Výroba
ProductionOnly
Standard

Type:	CheckpointType
Accepted values:	Disabled, Production, ProductionOnly, Standard
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearDRProtection

Označuje, že tato rutina resetuje možnost ochrany obnovení dat.

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

-Cloud

Určuje objekt privátního cloudu.

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

-ClusterNonPossibleOwner

Určuje seznam názvů ne možných vlastníků uzlů clusteru pro zadaný virtuální počítač.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterPreferredOwner

Určuje seznam názvů upřednostňovaných vlastníků uzlů clusteru pro konkrétní virtuální počítač.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CostCenter

Určuje nákladové středisko pro virtuální počítač. Můžete shromažďovat data o přidělení virtuálních počítačů nebo prostředků přidělených virtuálním počítačům pro váš fakturační systém.

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

-CPUCount

Určuje počet procesorů na virtuálním počítači. Následující hostitelé podporují následující počet procesorů:

Hyper-V. Až čtyři procesory na virtuální počítač v závislosti na hostovaném operačním systému.
VMware ESX. Až čtyři procesory na virtuální počítač pro libovolný podporovaný hostovaný operační systém s výjimkou jednoho procesoru na virtuálním počítači, na který běží systém Windows NT 4.0.
Citrix XenServer. Až osm procesorů na virtuální počítač v závislosti na hostovaném operačním systému

Type:	Byte
Aliases:	ProcessorCount
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUExpectedUtilizationPercent

Určuje procento procesoru na hostiteli, kterého očekáváte, že tento virtuální počítač bude používat. Tato hodnota se používá pouze v případě, že nástroj VMM určí vhodného hostitele pro virtuální počítač.

Type:	Int32
Aliases:	ExpectedCPUUtilization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPULimitForMigration

Určuje, jestli chcete omezit funkce procesoru pro zadaný virtuální počítač, aby bylo možné migraci na fyzický počítač, který má jinou verzi stejného procesoru jako zdrojový počítač. Nástroj VMM nepodporuje migraci virtuálních počítačů mezi fyzickými počítači, které mají procesory od různých výrobců.

Type:	Boolean
Aliases:	LimitCPUForMigration
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPULimitFunctionality

Určuje, jestli má virtuální počítač poskytovat omezené funkce procesoru. Zadejte hodnotu $True pro podporu staršího operačního systému, například systém Windows NT 4.0, na virtuálním počítači nasazeného na hostiteli Hyper-V nebo na hostiteli VMware ESX.

Type:	Boolean
Aliases:	LimitCPUFunctionality
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUMaximumPercent

Určuje nejvyšší procento celkových prostředků jednoho procesoru na hostiteli, který může virtuální počítač používat současně.

Type:	Int32
Aliases:	CPUMax
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUPerVirtualNumaNodeMaximum

Určuje maximální počet procesorů povolených pro každý virtuální uzel NUMA.

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

-CPURelativeWeight

Určuje množství prostředků procesoru na hostiteli, který může tento virtuální počítač používat vzhledem k jiným virtuálním počítačům na stejném hostiteli. Virtuální počítač s vyšší hodnotou váhy je přidělen více prostředků procesoru než virtuální počítač s nižší hodnotou váhy. Termín VMware pro tyto hodnoty je sdílený. Typy hostitelů podporují následující relativní hodnoty:

Hyper-V. 1 až 10000.
VMware ESX. Vysoká. 2000.
VMware ESX. Nad normálním. 1500.
VMware ESX. Normální (výchozí). 1000.
VMware ESX. Pod normálním. 750.
VMware ESX. Nízká. 500.
VMware ESX. Vlastní 1 až 1000000.
Citrix XenServer. 1 až 65536, typické je 256.

Type:	Int32
Aliases:	RelativeWeight
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUReserve

Určuje minimální procento prostředků jednoho procesoru na hostiteli, které se mají virtuálnímu počítači přidělit. Procento kapacity procesoru, která je k dispozici pro virtuální počítač, není nikdy menší než toto procento.

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

-CPUType

Určuje typ procesoru pro virtuální počítač. Pokud chcete získat všechny typy procesoru, které jsou k dispozici pro použití ve virtuálních počítačích v prostředí VMM, přečtěte si rutinu Get-SCCPUType .

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