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).

Mezi vlastnosti, které můžete změnit, patří:

Přidružte virtuální počítač ke cloudu.
Název, vlastník a popis virtuálního počítače.
Pořadí spouš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.
Očekává se využití procesoru hostitele virtuálním počítačem.
Množství prostředků procesoru hostitele využívaných jedním virtuálním počítačem vzhledem k jiným virtuálním počítačům na stejném hostiteli
Velikost hostitelské paměti, kterou může virtuální počítač použít.
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čky 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 za účelem jeho zpřístupnění nebo dočasného nedostupnosti uživatelům
Povolení zálohování virtuálního počítače na hostiteli Hyper-V pomocí služby Stínová kopie svazku
Povolení dvojice 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í časové synchronizace mezi virtuálním počítačem a jeho hostitelem Hyper-V
Povolení hodnoty systému BIOS pro NumLock pro virtuální počítač na hostiteli Hyper-V
Nastavení, které určuje, jestli je virtuální počítač vysoce dostupný, to znamená virtuální počítač, který má být nasazen na uzlu hostitelského clusteru Hyper-V nebo hostitelského clusteru Citrix XenServer.
Nastavení určující, jestli se služby hosta virtualizace nainstalují na virtuální počítač nasazený na hostiteli Hyper-V.
Počet sekund zpoždění před spuštěním virtuálního počítače
Nastavení, které identifikuje operační systém používaný pro virtuální počítač.
Akce spuštění a zastavení virtuálního počítače
Nastavení, které omezuje počet virtuálních počítačů, které můžou uživatelé samoobslužně vytvářet.
Nastavení sloužící 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 zdrojů 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 uloží ho do proměnné $VM.

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

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žívané 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á z VMMServer01 objekt virtuálního počítače S názvem VM02 a uloží ho do proměnné $VM.

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

Poslední příkaz určuje, že členové role samoobslužného uživatele s názvem SSUserRole3 mají nyní udělené 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. Ke konfiguraci tohoto nastavení obvykle není nutné 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ůže se stát, že budete chtít 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 ilustruje 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 $EAP proměnných. Tato proměnná se později použije k vrácení původní hodnoty nastavení.

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ána jako výjimka namísto zápisu do výstupního kanálu a příkaz nebude pokračovat ve spuštění.

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. Zakázání časové synchronizace se obvykle vyžaduje u virtuálních počítačů, které fungují jako řadiče domény. Příkaz používá příkaz trap k zachycení ukončující výjimky. Pokud příkaz Set-SCVirtualMachine selže, zobrazí se řetězec v příkazu trap . Continue se v příkazu trapu používá k tomu, aby místo ukončení pokračoval ve spuštění. Rutina Out-Null přesměruje výstup do $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 později použije k vrácení původní hodnoty nastavení.

Druhý příkaz nastaví předvolbu chybové akce na Zastavit. Tato předvolba akce chyby změní chybu z neukončující chyby na ukončující chybu. Objekt chyby je vyvolána jako výjimka namísto zápisu do výstupního kanálu a příkaz nebude pokračovat ve spuštění.

Třetí příkaz načte, že každý objekt virtuálního počítače uloží objekty v $VMs. Použití symbolu @ a závorek zajistí, že příkaz uloží výsledky do pole pro 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,Floppy. Příkaz používá příkaz trapu k zachycení ukončující výjimky. Pokud příkaz Set-SCVirtualMachine selže, zobrazí se řetězec v příkazu trap. Continue se v příkazu trapu používá k pokračování ve spuštění namí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 $ErrorActionPreference na hodnotu uloženou v protokolu EAP.

Další informace o standardním příkazu smyčky Windows PowerShell ForEach potřebujete zadáním Get-Help about_ForEachpříkazu .

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 načte všechny objekty virtuálních počítačů na serveru VMMServer01, vybere pouze ty objekty virtuálních počítačů, u kterých není uveden žádný vlastník, a určí vlastníka každého virtuálního počítače.

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í se virtuální počítač nacházet 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 v vypnutém stavu. Pokud virtuální počítač není v 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í velikost paměti na 2048 MB. Spouštěcí paměť je množství paměti na hostiteli, která je přidělena 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ělena virtuálnímu počítači VM06.

Parametry

-AutomaticCriticalErrorAction

Určuje akci, která se má provést, když virtuální počítač narazí na kritickou chybu a překročí dobu trvání časového limitu určené 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 v minutách, po kterou se má čekat v kritické pauze 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

Určuje, jestli je pro virtuální počítač zablokovaná dynamická optimalizace.

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

-BootOrder

Určuje pořadí jako pole 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ů 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 se systémem 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é očekáváte, že tento virtuální počítač bude používat. Tato hodnota se použije 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 se mají omezit funkce procesoru pro zadaný virtuální počítač, aby bylo možné provést 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 se mají virtuálnímu počítači poskytnout 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ému 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 z 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í povolený počet procesorů 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ímu počítači s vyšší váhou je přiděleno více prostředků procesoru než virtuálnímu počítači s nižší hodnotou váhy. Termínem VMware pro tyto hodnoty jsou sdílené složky. 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í. 750.
VMware ESX. Nízká. 500.
VMware ESX. Vlastní 1 až 1000000.
Citrix XenServer. 1 až 65536, obvykle 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 má přidělit virtuálnímu počítači. Procento kapacity procesoru, které je k dispozici pro virtuální počítač, není nikdy nižší 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 procesorů, které jsou k dispozici pro použití ve virtuálních počítačích v prostředí VMM, projděte si rutinu Get-SCCPUType .

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