Set-SCVMTemplate

Referens

Modul:: VirtualMachineManager

Ändrar egenskaper för en mall för virtuella datorer som används i VMM.

Syntax

Set-SCVMTemplate
   [-VMTemplate] <Template>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-ApplicationProfile <ApplicationProfile>]
   [-SQLProfile <SQLProfile>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-LinuxDomainName <String>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-UpdateManagementProfile <AzureProfile>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-Domain <String>]
   [-DeploymentTypeNano <Boolean>]
   [-Workgroup <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-UserRole <UserRole>]
   [-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>]
   [<CommonParameters>]

Set-SCVMTemplate
   [-VMTemplate] <Template>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-ApplicationProfile <ApplicationProfile>]
   [-SQLProfile <SQLProfile>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-LinuxDomainName <String>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-UpdateManagementProfile <AzureProfile>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-Domain <String>]
   [-DeploymentTypeNano <Boolean>]
   [-Workgroup <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-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>]
   [<CommonParameters>]

Description

Anteckning

En ny parameter [-EnableNestedVirtualization] ingår i VMM 2019 UR1. Mer information finns i Parametrar.

Cmdleten Set-SCVMTemplate ändrar en eller flera egenskaper för en mall för virtuella datorer som används i en VMM-miljö (Virtual Machine Manager).

Egenskaper som du kan ändra inkluderar inställningar för namnet på mallen, dess beskrivning, ägare, organisationsnamn, tidszon, operativsystem och produktnyckel. BIOS-startordning; CPU-nummer och egenskaper; mängden minne på värden som är tilldelad till en virtuell dator. Mängden bandbredd på värdens nätverk som är tillgängligt för en virtuell dator. om en virtuell dator som skapats med den här mallen kommer att ha hög tillgänglighet (dvs. distribuerad på en värd som ingår i ett värdkluster); värden för domän eller arbetsgrupp samt domänautentiseringsuppgifter; en punktkvot som anger hur många nya virtuella datorer som självbetjäningsanvändare kan skapa. anpassade fält; och andra alternativ.

Ändringar som du gör i en mall påverkar bara mallen. Ändringar påverkar inte befintliga virtuella datorer som tidigare skapades med hjälp av den här mallen.

Om du vill ändra egenskaperna för en virtuell diskenhet, virtuell diskettenhet, virtuell DVD-enhet, virtuellt nätverkskort, virtuell SCSI-adapter eller virtuell COM-port som är associerad med en specifik mall kan du använda Set-SCVirtualDiskDrive, Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter, Set-SCVirtualScsiAdapter eller Set-SCVirtualCOMPortdlets .

Exempel

Exempel 1: Ange en mängd minne för en befintlig mall för virtuella datorer

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Set-SCVMTemplate -Template $Template -MemoryMB 1024

Det första kommandot hämtar mallobjektet vmTemplate01 från VMM-biblioteket och lagrar objektet i variabeln $Template.

Det andra kommandot ändrar minnesvärdet för VMTemplate01 till 1 024 MB. Det här är mängden minne på värden som en virtuell dator som skapas med hjälp av den här mallen kommer att använda.

Exempel 2: Ange en ny ägare för flera mallar för virtuella datorer med hög tillgänglighet

PS C:\> $VMTemplates = Get-SCVMTemplate | where {$_.IsHighlyAvailable}
PS C:\> ForEach ($VMTemplate in $VMTemplates) {Set-SCVMTemplate $VMTemplate -Owner "Contoso\NevenSokec"}

Det första kommandot hämtar alla mallobjekt för virtuella datorer med hög tillgänglighet och lagrar objekten i $VMTemplates objektmatris.

Det andra kommandot använder en ForEach-loop för att ange en ny ägare för var och en av mallarna i $VMTemplates matris.

Om du vill ha information om standard-PowerShell ForEach-loop-instruktionen skriver du .Get-Help about_ForEach

Exempel 3: Ange en ny ägare för alla mallar för virtuella datorer som har samma ägare

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

Det här kommandot hämtar alla mallobjekt för virtuella datorer från VMM-biblioteket, markerar endast de objekt vars ägare är "Contoso\PattiFuller" och skickar sedan varje objekt till cmdleten Set-SCVMTemplate , som ändrar ägaren till Contoso| AllieSloan.

Exempel 4: Aktivera dynamiskt minne för en befintlig mall för virtuella datorer

PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate04"}
PS C:\> Set-SCVMTemplate -VMTemplate $VMTemplate -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

Det första kommandot hämtar mallobjektet för den virtuella datorn med namnet VMTemplate04 från VMM-biblioteket och lagrar objektet i variabeln $VMTemplate.

Det andra kommandot aktiverar dynamiskt minne, ändrar startminnesvärdet för VMTemplate04 till 1 024 MB (det här är mängden minne på värden som en virtuell dator som skapats med hjälp av den här mallen allokeras vid start) och anger det maximala minnesvärdet till 2 048 MB (det här är den maximala mängden minne som kan allokeras till en virtuell dator som skapats med hjälp av den här mallen). En virtuell dator med dynamiskt minne kan bara distribueras på en värd som kör Windows Server 2008 R2 SP1 eller senare.

Exempel 5: Ange rotlösenordet för en befintlig anpassningsbar mall för virtuella Linux-datorer

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "LinuxVMTemplate01"}
PS C:\> $Creds = Get-Credential
PS C:\> Set-SCVMTemplate -Template $Template -LocalAdministratorCredential $Creds

Det första kommandot hämtar mallobjektet för den virtuella datorn med namnet LinuxVMTemplate01 från VMM-biblioteket och lagrar objektet i variabeln $Template.

Det andra kommandot hämtar ett användarnamn (rot) och lösenord via kommandot Get-Credential och lagrar resultatet i variabeln $Creds.

Det senaste kommandot anger rotkontots lösenord till lösenordet som lagras i variabeln $Creds.

Exempel 6: Aktivera azure update management-funktioner på en befintlig mall för virtuella datorer.

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $azureProfile = Get-SCAzureProfile | where { $_.Name -eq "AzUpdateMgmtProfile"}
PS C:\> Set-SCVMTemplate -Template $Template -UpdateManagementProfile $azureProfile

Det första kommandot hämtar mallobjektet vmTemplate01 från VMM-biblioteket och lagrar objektet i variabeln $Template.

Det andra kommandot hämtar en azure update management-profil från VMM-biblioteket och lagrar objektet i variabeln $azureProfile.

Det tredje kommandot aktiverar mallen med azure update management-funktioner genom att länka en Azure-profil.

Exempel 7: Inaktivera azure update management-funktioner på en mall för virtuella datorer.

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Set-SCVMTemplate -Template $Template -UpdateManagementProfile $null

Det första kommandot hämtar mallobjektet vmTemplate01 från VMM-biblioteket och lagrar objektet i variabeln $Template.

Det andra kommandot inaktiverar mallen med azure update management-funktioner.

Parametrar

-AnswerFile

Anger ett skriptobjekt som lagras i VMM-biblioteket (Virtual Machine Manager) som ska användas som svarsfil. Namnet på svarsfilskriptet beror på vilket operativsystem du vill installera på en virtuell dator:

Sysprep.inf. Windows XP, Windows Server 2000 eller Windows Server 2003
Unattend.xml. Windows Vista, Windows 7 eller Windows Server 2008

Type:	Script
Aliases:	SysPrepFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationProfile

Anger ett programprofilobjekt.

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

-AutoLogonCount

Anger hur många gånger som Windows automatiskt ska logga administratören som anges i svarsfilen på konsolsessionen.

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

-AutoLogonCredential

Anger kör som-kontot som finns i svarsfilen som Windows använder för att logga in på konsolsessionen när automatisk administratörsinloggning är aktiverad.

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

-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

-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 typ av kontrollpunkt. 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 alternativet för haveriberedskapsskydd.

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

-ComputerName

Anger namnet på en dator som VMM unikt kan identifiera i nätverket. De acceptabla värdena för den här parametern är:

FQDN
IPv4- eller IPv6-adress
NetBIOS-namn

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

-CostCenter

Anger kostnadsställe för en virtuell dator så att du kan samla in data om allokering av virtuella datorer (eller resurser som allokerats till virtuella datorer) för användning av i ditt faktureringssystem.

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

-CPUCount

Anger antalet processorer på en virtuell dator, i en maskinvaruprofil eller i en mall.

Typer av 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, men bara 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 aktivera körning av ett äldre operativsystem som Windows NT 4.0 på en virtuell dator som distribuerats på en Hyper-V-värd eller på en VMware ESX-värd genom att tillhandahålla begränsade CPU-funktioner för den virtuella datorn.

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 enskild PROCESSOR på värden som kan användas av en specifik virtuell dator vid en viss tidpunkt.

Exempel: -CPUMaximumPercent 80 (för att ange 80 procent)

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 1000000.
Citrix XenServer. 1 till 65536, normal ä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 enskild processor på värden som ska allokeras till en virtuell dator. 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 processor för en virtuell dator. Om du vill hämta en lista över alla cpu-typer som är tillgängliga för användning i virtuella datorer i en VMM-miljö skriver du Get-SCCPUType.

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