Set-SCVirtualMachine

Referens

Modul:: VirtualMachineManager

Ändrar egenskaper för en virtuell dator som hanteras av 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

Cmdleten Set-SCVirtualMachine ändrar egenskaperna för en virtuell dator som hanteras av Virtual Machine Manager (VMM).

Egenskaper som du kan ändra omfattar följande:

Associera en virtuell dator med ett moln.
Namn, ägare och beskrivning av en virtuell dator.
BIOS-startordning om den virtuella datorn distribueras på en Hyper-V-värd.
Mängden resurser på värden som används av en virtuell dator. Exempel på dessa är:
Maximal mängd cpu-värdresurser som en virtuell dator kan använda.
Förväntad användning av värd-CPU av en virtuell dator.
Mängden cpu-värdresurser som används av en virtuell dator i förhållande till andra virtuella datorer på samma värd.
Mängden värdminne som en virtuell dator kan använda.
Mängden bandbredd i värdens nätverk som en virtuell dator kan använda.
Maskinvaruinställningar för en virtuell dator som inte är relaterade till värdresurser. Exempel på dessa är:
Antal processorer.
Typ av PROCESSOR.
Antal in- och utdataåtgärder per sekund (IOPS).
Begränsning av CPU-funktioner för ett äldre operativsystem, till exempel Windows NT 4.0.
Kostnadsställe, tagg och anpassade inställningar som används för att filtrera virtuella datorer efter kriterier.
Inställningar som aktiverar olika valfria funktioner, bland annat följande:
Aktivera eller inaktivera ett biblioteksobjekt för att göra det tillgängligt, eller tillfälligt otillgängligt, för användare.
Aktivera säkerhetskopiering av en virtuell dator på en Hyper-V-värd med tjänsten Volume Shadow Copy.
Aktivera ett nyckel/värde-par för datautbyte mellan en virtuell dator och dess Hyper-V-värd.
Aktivera avstängning av en virtuell dator från Hyper-V-konsolen.
Aktivera tidssynkronisering mellan en virtuell dator och dess Hyper-V-värd.
Aktivera BIOS-värdet för NumLock för en virtuell dator på en Hyper-V-värd.
Inställning som anger om en virtuell dator har hög tillgänglighet, d.v.s. en virtuell dator som ska distribueras på en nod i ett Hyper-V-värdkluster eller ett Citrix XenServer-värdkluster.
Inställning som avgör om virtualiserings gästtjänster är installerade på en virtuell dator som distribueras på en Hyper-V-värd.
Antal sekunder som ska fördröjas innan en virtuell dator startas.
Inställning som identifierar det operativsystem som används för en virtuell dator.
Start- och stoppåtgärder för en virtuell dator.
Inställning som begränsar antalet virtuella datorer som självbetjäningsanvändare kan skapa.
Inställning som används för att växla den roll som en självbetjäningsanvändare som tillhör flera roller använder för att hantera en virtuell dator.
Inställning som tilldelar en virtuell dator på en ESX-värd till en VMware-resurspool.

Om du vill ändra egenskaperna för en virtuell diskettenhet, en virtuell DVD-enhet, ett virtuellt nätverkskort eller ett virtuellt SCSI-kort som är associerat med en specifik virtuell dator använder du cmdleten Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter eller Set-SCVirtualScsiAdapter .

Exempel

Exempel 1: Ange en mängd minne för en befintlig virtuell dator

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

Det första kommandot hämtar det virtuella datorobjektet med namnet VM01 och lagrar sedan objektet i variabeln $VM.

Den andra avgör om den virtuella datorn som lagras i $VM är avstängd. Om den virtuella datorn inte är avstängd använder kommandot kommandot Stop-SCVirtualMachine för att stänga av den virtuella datorn. Om du vill ha mer information om hur du stänger av en virtuell dator skriver du Get-Help Stop-SCVirtualMachine.

Det senaste kommandot ändrar det tilldelade minnet till VM01 till 1 024 MB.

Exempel 2: Ändra användarrollen som används för att hantera en virtuell dator för en användare som tillhör flera självbetjäningsanvändarroller

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

Det första kommandot hämtar det virtuella datorobjektet vm02 från VMMServer01 och lagrar sedan objektet i variabeln $VM.

Det andra kommandot hämtar användarrollobjektet med namnet ContosoSelfServiceUsers och lagrar sedan objektet i variabeln $SSRole.

Det sista kommandot anger att medlemmar i självbetjäningsanvändarrollen SSUserRole3 nu beviljas behörighet att hantera den virtuella datorn vm02.

Obs! VMM använder parametern UserRole för att ange vilka virtuella datorer som hanteras av medlemmarna i en specifik självbetjäningsanvändarroll. Normalt behöver du inte använda cmdleten Set-SCVirtualMachine med parametern UserRole för att konfigurera den här inställningen. Men om en eller flera användare är medlemmar i flera självbetjäningsanvändarroller och du ger dem behörighet att hantera flera virtuella datorer på samma värd, kan du stöta på ett fall där du vill byta vilken användarroll som har behörighet att hantera en viss virtuell dator. Det här exemplet illustrerar det scenariot.

Exempel 3: Inaktivera tidssynkronisering på en virtuell dator som används som domänkontrollant

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

Det första kommandot lagrar den aktuella inställningen för $ErrorActionPreference i variabeln $EAP. Den här variabeln används senare för att returnera inställningen till dess ursprungliga värde.

Det andra kommandot anger åtgärdsinställningen till STOP. Den här felåtgärdsinställningen ändrar ett fel från ett icke-avslutande fel till ett avslutande fel. Felobjektet utlöses som ett undantag i stället för att skrivas till utdatapipan och kommandot fortsätter inte att köras.

Det tredje kommandot hämtar det virtuella datorobjektet med namnet VM03 och lagrar objektet i variabeln $VM.

Det fjärde kommandot inaktiverar inställningen för tidssynkronisering. Normalt krävs inaktivering av tidssynkronisering för virtuella datorer som fungerar som domänkontrollanter. Kommandot använder trap-instruktionen för att fånga avslutande undantag. Om kommandot Set-SCVirtualMachine misslyckas visas strängen i trap-instruktionen . Fortsätt används i trap-instruktionen för att fortsätta köra i stället för att avsluta. Cmdleten Out-Null omdirigerar utdata till $Null i stället för att skicka dem till konsolen.

Det sista kommandot anger värdet för $ErrorActionPreference till värdet som lagras i $EAP.

Exempel 4: Ange enhetens startordning för alla virtuella datorer som stöder den här funktionen

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

Det första kommandot lagrar den aktuella inställningen för $ErrorActionPreference i $EAP. Den här variabeln används senare för att returnera inställningen till dess ursprungliga värde.

Det andra kommandot anger felåtgärdsinställningen till Stoppa. Den här felåtgärdsinställningen ändrar ett fel från ett icke-avslutande fel till ett avslutande fel. Felobjektet utlöses som ett undantag i stället för att skrivas till utdatapipan och kommandot fortsätter inte att köras.

Det tredje kommandot hämtar varje virtuellt datorobjekt som lagrar objekten i $VMs. Med @-symbolen och parenteserna ser du till att kommandot lagrar resultatet i en matris om kommandot returnerar ett enskilt objekt eller ett null-värde.

Det fjärde kommandot anger BIOS-startordningen för varje virtuell dator till PXEBoot,IDEHarddrive,CD,Floppy. Kommandot använder en trap-instruktion för att fånga avslutande undantag. Om kommandot Set-SCVirtualMachine misslyckas visas strängen i trap-instruktionen. Continue används i trap-instruktionen för att fortsätta köra i stället för att avsluta ForEach-loopen . Out-Null-cmdleten omdirigerar utdata till $Null i stället för att skicka dem till konsolen.

Obs! Parametern BootOrder används endast för virtuella datorer på Hyper-V- och Citrix XenServer-värdar. Den används inte för virtuella datorer på VMware ESX-värdar. XenServer-värdar stöder inte disketter och ignorerar därför disketter om de anges i startordningen.

Det sista kommandot anger värdet för $ErrorActionPreference till värdet som lagras i EAP.

Om du vill ha mer information om standard-Windows PowerShell ForEach-loopsatsen skriver du Get-Help about_ForEach.

Exempel 5: Ange en ägare för alla virtuella datorer utan ägare

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

Det här kommandot hämtar alla virtuella datorobjekt på VMMServer01, väljer endast de virtuella datorobjekt där ingen ägare visas och anger en ägare för varje virtuell dator.

Exempel 6: Aktivera dynamiskt minne för en befintlig virtuell dator

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

Det första kommandot hämtar det virtuella datorobjektet VM06 och lagrar objektet i variabeln $VM. Om du vill aktivera dynamiskt minne på en virtuell dator måste den finnas på en värd som kör Windows Server 2008 R2 SP1 eller en senare version.

Det andra kommandot avgör om den virtuella datorn som lagras i $VM är avstängd. Om den virtuella datorn inte är avstängd använder kommandot kommandot Stop-SCVirtualMachine för att stänga av den virtuella datorn.

Det sista kommandot aktiverar dynamiskt minne, anger startminnet till 1 024 MB och anger maximalt minne till 2 048 MB. Startminnet är mängden minne på värden som allokeras till VM06 vid start. Det maximala minnet är den maximala mängden minne på värden som allokeras till VM06.

Parametrar

-AutomaticCriticalErrorAction

Anger vilken åtgärd som ska vidtas när den virtuella datorn stöter på ett kritiskt fel och överskrider den tidsgräns som anges av parametern AutomaticCriticalErrorActionTimeout . Godkända värden för den här parametern är: Pausa och Ingen.

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

-AutomaticCriticalErrorActionTimeout

Anger hur lång tid, i minuter, att vänta i kritisk paus innan den virtuella datorn stängs av.

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

-AvailabilitySetNames

Anger en lista över namn på tillgänglighetsuppsättningar.

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

-BlockDynamicOptimization

Anger om dynamisk optimering blockeras för en virtuell dator.

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

-BootOrder

Anger ordningen, som en matris, på enheter som en virtuell dator på en Hyper-V-värd använder för att starta. Giltiga värden är:

CD
IDEHardDrive
PXEBoot
Diskett

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

Anger ett funktionsprofilobjekt.

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

-CheckpointType

Anger kontrollpunktstypen. De acceptabla värdena för den här parametern är:

Inaktiverad
Produktion
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

Anger att den här cmdleten återställer dataskyddsalternativet.

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

-Cloud

Anger ett privat molnobjekt.

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

-ClusterNonPossibleOwner

Anger en lista med namn på icke-möjliga klusternodägare för en angiven virtuell dator.

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

Anger en lista med namn på önskade klusternodsägare för en viss virtuell dator.

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

Anger kostnadsställe för en virtuell dator. Du kan samla in data om allokering av virtuella datorer eller resurser som allokerats till virtuella datorer för ditt faktureringssystem.

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

-CPUCount

Anger antalet processorer på den virtuella datorn. Följande värdar stöder följande antal processorer:

Hyper-V. Upp till fyra processorer per virtuell dator, beroende på gästoperativsystem.
VMware ESX. Upp till fyra processorer per virtuell dator för alla gästoperativsystem som stöds, förutom en PROCESSOR på en virtuell dator som kör Windows NT 4.0.
Citrix XenServer. Upp till åtta processorer per virtuell dator, beroende på gästoperativsystem.

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

-CPUExpectedUtilizationPercent

Anger procentandelen cpu på värden som du förväntar dig att den här virtuella datorn ska använda. Det här värdet används endast när VMM avgör en lämplig värd för den virtuella datorn.

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

-CPULimitForMigration

Anger om processorfunktionerna för den angivna virtuella datorn ska begränsas för att möjliggöra migrering till en fysisk dator som har en annan version av samma processor som källdatorn. VMM stöder inte migrering av virtuella datorer mellan fysiska datorer som har processorer från olika tillverkare.

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

-CPULimitFunctionality

Anger om du vill tillhandahålla begränsad CPU-funktionalitet för den virtuella datorn. Ange ett värde för $True för att stödja ett äldre operativsystem, till exempel Windows NT 4.0, på en virtuell dator som distribuerats på en Hyper-V-värd eller på en VMware ESX-värd.

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

-CPUMaximumPercent

Anger den högsta procentandelen av de totala resurserna för en enda PROCESSOR på värden som en virtuell dator kan använda samtidigt.

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

-CPUPerVirtualNumaNodeMaximum

Anger det maximala antalet processorer som tillåts för varje virtuell NUMA-nod.

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

-CPURelativeWeight

Anger mängden CPU-resurser på en värd som den här virtuella datorn kan använda i förhållande till andra virtuella datorer på samma värd. En virtuell dator med ett högre viktvärde tilldelas fler CPU-resurser än en virtuell dator med ett lägre viktvärde. VMware-termen för dessa värden är resurser. Typer av värdar stöder följande relativa värden:

Hyper-V. 1 till 10 000.
VMware ESX. Hög. 2000.
VMware ESX. Ovanför Normal. 1500.
VMware ESX. Normal (standard). 1000.
VMware ESX. Under Normal. 750.
VMware ESX. Låg. 500.
VMware ESX. Anpassad 1 till 10000000.
Citrix XenServer. 1 till 65536, typiskt är 256.

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

-CPUReserve

Anger den minsta procentandelen av resurserna för en enda PROCESSOR på värden som ska allokeras till den virtuella datorn. Procentandelen cpu-kapacitet som är tillgänglig för den virtuella datorn är aldrig mindre än den här procentandelen.

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

-CPUType

Anger typen av CPU för en virtuell dator. Information om hur du hämtar alla cpu-typer som är tillgängliga för användning på virtuella datorer i en VMM-miljö finns i cmdleten Get-SCCPUType .

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