Set-SCVMTemplate

參考

模組:: VirtualMachineManager

變更 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

注意

VMM 2019 UR1 和更新版本中包含新的參數 [-EnableNestedVirtualization] <布爾> 值。如需詳細資訊，請參閱參數。

Set-SCVMTemplate Cmdlet 會變更 Virtual Machine Manager (VMM) 環境中所使用的虛擬機範本一或多個屬性。

您可以變更的屬性包括範本名稱、其描述、擁有者、組織名稱、時區、操作系統和產品密鑰的設定;BIOS 開機順序;CPU 數目和特性;指派給虛擬機之主機上的記憶體數量;虛擬機可用主機網路上的頻寬量;使用此範本建立的虛擬機是否為高可用性 (，亦即部署在屬於主機叢集一部分的主機上) ;定義域或工作組的值以及網域認證;指定可建立多少新虛擬機自助用戶的點配額;自訂欄位;和其他選項。

對範本進行的變更只會影響範本。變更不會影響先前使用此範本建立的任何現有虛擬機。

如果您想要變更虛擬磁碟驅動器的屬性，虛擬磁碟驅動器、虛擬 DVD 磁碟驅動器、虛擬網路適配器、虛擬 SCSI 適配卡或與特定範本相關聯的虛擬 COM 連接埠，您可以分別使用 Set-SCVirtualDiskDrive、Set-SCVirtualFloppyDrive、Set-SCVirtualVPDrive、Set-SCVirtualNetworkAdapter、Set-SCVirtualScsiAdapter 或 Set-SCVirtualCOMPort Cmdlet。

範例

範例 1：指定現有虛擬機範本的記憶體數量

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

第一個命令會從 VMM 連結庫取得名為 VMTemplate01 的虛擬機範本物件，並將物件儲存在 $Template 變數中。

第二個命令會將 VMTemplate01 的記憶體值變更為 1024 MB。這是使用此範本所建立虛擬機的主機上的記憶體數量。

範例 2：為多個高可用性虛擬機範本指定新的擁有者

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

第一個命令會取得所有高可用性的虛擬機範本物件，並將物件儲存在$VMTemplates對象陣列中。

第二個命令會使用 ForEach 循環，為$VMTemplates陣列中的每個範本指定新的擁有者。

如需標準 PowerShell ForEach 循環語句的相關信息，請輸入 Get-Help about_ForEach。

範例 3：為具有相同擁有者的所有虛擬機範本指定新的擁有者

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

此命令會從 VMM 連結庫取得所有虛擬機範本物件、只選取擁有者為 “Contoso\PattiFuller” 的物件，然後將每個對象傳遞至 Set-SCVMTemplate Cmdlet，以將擁有者變更為 Contoso|AllieSloan。

範例 4：為現有的虛擬機範本啟用易失記憶體

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

第一個命令會從 VMM 連結庫取得名為 VMTemplate04 的虛擬機範本物件，並將物件儲存在$VMTemplate變數中。

第二個命令會啟用易失記憶體、將 VMTemplate04 的啟動記憶體值變更為 1024 MB， (這是使用此範本建立的虛擬機在) 啟動時配置的記憶體數量) ，並將最大記憶體值設定為 2048 MB (這是可使用此範本建立的虛擬機的最大記憶體數量) 。使用易失記憶體的虛擬機只能部署在執行 Windows Server 2008 R2 SP1 或更新版本的主機上。

範例 5：指定現有可自定義 Linux 虛擬機範本的根密碼

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

第一個命令會從 VMM 連結庫取得名為 LinuxVMTemplate01 的虛擬機範本物件，並將物件儲存在 $Template 變數中。

第二個命令會透過 Get-Credential 命令取得 (根) 和密碼的使用者名稱，並將結果儲存在 $Creds 變數中。

最後一個命令會將根帳戶密碼設定為儲存在 $Creds 變數中的密碼。

範例 6：在現有的 VM 範本上啟用 Azure 更新管理功能。

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

第一個命令會從 VMM 連結庫取得名為 VMTemplate01 的虛擬機範本物件，並將物件儲存在 $Template 變數中。

第二個命令會從 VMM 連結庫取得 Azure 更新管理配置檔，並將物件儲存在$azureProfile變數中。

第三個命令會連結 Azure 配置檔，以啟用具有 azure 更新管理功能的範本。

範例 7：停用 VM 範本上的 Azure 更新管理功能。

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

第一個命令會從 VMM 連結庫取得名為 VMTemplate01 的虛擬機範本物件，並將物件儲存在 $Template 變數中。

第二個命令會停用具有 azure 更新管理功能的範本。

參數

-AnswerFile

指定儲存在 Virtual Machine Manager (VMM) 連結庫中的腳本物件，以作為回應檔案使用。回應檔案指令碼的名稱視您要在虛擬機器上安裝的作業系統而異：

Sysprep.inf。 Windows XP、Windows Server 2000 或 Windows Server 2003
Unattend.xml。 Windows Vista、Windows 7 或 Windows Server 2008

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

-ApplicationProfile

指定應用程式設定檔物件。

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

-AutoLogonCount

指定 Windows 應該自動將回應檔案中表示的系統管理員記錄到主控台工作階段的次數。

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

-AutoLogonCredential

指定當啟用自動系統管理員登入時，Windows 用來登入主控台工作階段的回應檔案中包含的執行身分帳戶。

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

-AutomaticCriticalErrorAction

指定虛擬機遇到重大錯誤時所要採取的動作，並超過 AutomaticCriticalErrorActionTimeout 參數所指定的逾時持續時間。此參數可接受的值為：Pause 和 None。

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

-AutomaticCriticalErrorActionTimeout

指定在關閉虛擬機電源之前，等待重大暫停的時間量，以分鐘為單位。

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

-BlockDynamicOptimization

指出是否封鎖虛擬機的動態優化。

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

-BootOrder

指定 Hyper-V 主機上虛擬機用來啟動之裝置的順序，做為數位。有效值為：

CD
IDEHardDrive
PXEBoot
磁碟機

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

指定功能設定檔物件。

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

-CheckpointType

指定檢查點類型。此參數可接受的值為：

已停用
生產
ProductionOnly
標準

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

-ClearDRProtection

表示此 Cmdlet 會重設災害復原保護選項。

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

-ComputerName

指定 VMM 可在您的網路中唯一識別的電腦名稱。此參數可接受的值為：

FQDN
IPv4 或 IPv6 位址
NetBIOS 名稱

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

-CostCenter

指定虛擬機器的成本中心，以便您可以收集虛擬機器配置 (或者配置給虛擬機器的資源) 的相關資料，而收集的資料可運用在計費系統中。

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

-CPUCount

在虛擬機器、硬體設定檔或範本上指定 CPU 數目。

主機類型支援下列 CPU 數目：

Hyper-V。每個虛擬機最多四個CPU，視客體作業系統而定。
VMware ESX。每個虛擬機最多四個CPU，但在執行 Windows NT 4.0的虛擬機上，只有一個CPU。
Citrix XenServer。每個虛擬機最多八個CPU，視客體作業系統而定。

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

-CPUExpectedUtilizationPercent

指定您預期此虛擬機使用的主機上CPU百分比。只有在 VMM 判斷虛擬機器適用的主機時，才會使用此值。

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

-CPULimitForMigration

指出是否要限制指定虛擬機的處理器功能，以便移轉至與來源計算機不同版本的實體計算機。如果兩部實體電腦配備不同製造商生產的處理器，VMM 便無法支援在這些電腦之間移轉虛擬機器。

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

-CPULimitFunctionality

指出是否要在部署於 Hyper-V 主機的虛擬機上或 VMware ESX 主機上提供有限的 CPU 功能，以啟用執行較舊的操作系統，例如 Windows NT 4.0。

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

-CPUMaximumPercent

指定在任何特定時間，特定虛擬機器可以使用主機單一 CPU 總資源的最高百分比。

範例： -CPUMaximumPercent 80 (指定百分之 80)

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

-CPUPerVirtualNumaNodeMaximum

指定每個虛擬 NUMA 節點允許的最大 CPU 數目。

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

-CPURelativeWeight

指定此虛擬機器在主機上可以使用的 CPU 資源數量，這是與相同主機上其他虛擬機器相對的數量。具有較高權數值的虛擬機會配置比具有較低權數值的虛擬機配置更多的 CPU 資源。這些值的 VMware 詞彙是共用。

主機類型支援下列相對值：

Hyper-V。 1 到 10000。
VMware ESX。高。 2000.
VMware ESX。高於標準。 1500.
VMware ESX。一般 (預設) 。 1000。
VMware ESX。在 [一般] 下方。 750.
VMware ESX。低。 500.
VMware ESX。自訂 1 到 1000000。
Citrix XenServer。 1 到 65536，一般為 256。

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

-CPUReserve

指定要配置給虛擬機器之主機上單一 CPU 資源的百分比下限。虛擬機器可使用的 CPU 容量百分比絕不會低於這個百分比。

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

-CPUType

指定虛擬機器的 CPU 類型。若要擷取可用於 VMM 環境中虛擬機的所有 CPU 類型清單，請輸入 Get-SCCPUType。

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

-Custom1

指定虛擬機範本上的自訂屬性。

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

-Custom10

指定虛擬機範本上的自訂屬性。

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

-Custom2

指定虛擬機範本上的自訂屬性。

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

-Custom3

指定虛擬機範本上的自訂屬性。

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

-Custom4

指定虛擬機範本上的自訂屬性。

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

-Custom5

指定虛擬機範本上的自訂屬性。

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

-Custom6

指定虛擬機範本上的自訂屬性。

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

-Custom7

指定虛擬機範本上的自訂屬性。

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

-Custom8

指定虛擬機範本上的自訂屬性。

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

-Custom9

指定虛擬機範本上的自訂屬性。

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

-DeploymentTypeNano

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

-Description

指定虛擬機範本的描述。

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

-DisableAutoLogon

停用自動系統管理員登入。

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

-DiskIops

指定特定虛擬機器每秒鐘可以使用的主機磁碟輸入/輸出操作 (IOPS) 數目。

範例： -DiskIO 1500 (指定 1500 IOPS)

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

-Domain

指定 Active Directory 網域的完整網域名稱 (FQDN)。

範例格式： -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinCredential

指定有權將計算機加入網域之帳戶的使用者名稱和密碼。我們建議您使用有限的許可權帳戶，將計算機加入網域。這包括虛擬和實體計算機。

您可以使用目前的參數，在 VMHostProfile 上指定認證，以便將實體主計算機加入網域，或在新的或現有的範本、新的或現有的客體操作系統配置檔或新的虛擬機上指定認證，以便將虛擬機加入網域。

Type:	VMMCredential
Aliases:	JoinDomainCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainJoinOrganizationalUnit

指定計算機在自動安裝迷你安裝期間加入的組織單位。

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

-DRProtectionRequired

這個參數保留給未來使用。

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

-DynamicMemoryBufferPercentage

指定虛擬機目前記憶體配置上方的記憶體百分比，主機應該嘗試保留為緩衝區。預設值為 20。

範例格式： -DynamicMemoryTargetBufferPercentage 20

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

-DynamicMemoryEnabled

指出是否要啟用虛擬機的易失記憶體。您可以直接在虛擬機或用來建立虛擬機的範本或硬體配置檔上啟用易失記憶體。預設值是 False。

必要：只有在該虛擬機部署在執行 Windows Server 2008 SP1 或更新版本的主機上，或虛擬機儲存在連結庫中處於停止狀態，才能為虛擬機啟用易失記憶體， (儲存虛擬機的硬體變更，只有在虛擬機沒有快照集) 時，才能啟用虛擬機的動態記憶體。在儲存在連結庫的虛擬機上啟用易失記憶體，會將該機器的位置限制為執行 Windows Server 2008 SP1 或更新版本的主機。

範例格式： -DynamicMemoryEnabled $True

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

-DynamicMemoryMaximumMB

指定啟用易失記憶體時可配置給虛擬機的最大記憶體數量。預設值為 65536。

必要：只有當該虛擬機部署在執行 Windows Server 2008 R2 SP1 或更新版本的主機上，或虛擬機儲存在連結庫中處於停止狀態時，才能為虛擬機啟用易失記憶體， (儲存虛擬機的硬體變更只有在虛擬機沒有快照集) 時，才能啟用虛擬機的動態記憶體。在存放於程式庫的虛擬機器上啟用動態記憶體後，就只能將該機器放置到執行 Windows Server 2008 R2 SP1 或更新版本的主機。

範例格式： -DynamicMemoryMaximumMB 1024

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

-DynamicMemoryMinimumMB

指定啟用易失記憶體時可配置給虛擬機的最小記憶體數量。預設值為 65536。

範例格式： -DynamicMemoryMinimumMB 1024

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

-Enabled

當設定為 $True 時啟用物件，或在設定為 $False時停用物件。例如，如果您想升級虛擬機器範本的軟體時，您可以停用 VMM 程式庫的範本物件，暫時禁止使用者使用該物件。

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

-EnableNestedVirtualization

啟用巢狀虛擬化。

注意

此參數適用於 VMM 2019 UR1 和更新版本。

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

-FirstBootDevice

指定第一次嘗試開機的裝置。

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

-FullName

指定虛擬機器註冊者的名稱。

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

-GuiRunOnceCommands

指定要新增至自動響應檔案 之 [GuiRunOnce] 區段的命令陣列。在每個以雙引號括住的字串周圍使用單引號。

範例格式： -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

如您Windows PowerShell 如何使用引號的資訊，請輸入 Get-Help about_Quoting_Rules。

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

-HAVMPriority

指定虛擬機優先順序。虛擬機依優先順序啟動，上限為主機叢集節點的限制。此參數的有效輸入是優先順序的數值表示法：

高。 3000
中。 2000
低。 1000

如果您指定零 (0) 的值，則虛擬機不會自動重新啟動。

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

-HighlyAvailable

指出是否要將虛擬機放在屬於主機叢集一部分的 Hyper-V 主機上。請在虛擬機器或用來建立虛擬機器的範本或硬體設定檔上設定此設定。

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

-JobGroup

指定一系列命令的標識碼，這些命令會在包含相同作業群組標識符的執行的最後一個命令之前，以集合的形式執行。

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

-JobVariable

指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。

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

-LinuxAdministratorSSHKey

指定 Linux SSH 金鑰的公鑰檔案。

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

-LinuxAdministratorSSHKeyString

將 Linux 系統管理員 SSH 金鑰指定為字串。

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

-LinuxDomainName

指定與Linux作業系統特製化搭配使用的完整功能變數名稱 (FQDN) 。

範例格式： -LinuxDomainName "Domain01.Corp.Contoso.com"

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

-LocalAdministratorCredential

在 Linux 相容的客體作業系統設定檔) 的情況下，指定本機系統管理員帳戶 (或 Linux 根帳戶的使用者名稱和密碼。

在新的或現有的範本、新的或現有的客體作業系統配置檔上或新的虛擬機上指定認證，會覆寫任何現有的系統管理員密碼。

Type:	VMMCredential
Aliases:	AdminPasswordCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MemoryMB

指定此 Cmdlet 配置給已轉換虛擬機的主機上， (MB) RAM (RAM) 隨機存取記憶體的數量。預設值是 512 MB。針對在執行 Windows Server 2008 R2 SP1 或更新版本的主機上啟用易失記憶體的虛擬機，請指定啟動記憶體值。

主機類型具有下列可指派給虛擬機的最大記憶體：

Hyper-V。每個虛擬機最多 65536 MB RAM。
VMware ESX Server 3.0.x。每個虛擬機最多 16384 MB RAM。
VMware ESX Server 3.5.x。每個虛擬機最多 65532 MB RAM。
Citrix XenServer。每個虛擬機最多 32265 MB RAM。

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

-MemoryPerVirtualNumaNodeMaximumMB

指定允許每個虛擬 NUMA 節點的最大記憶體數量 MB。

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

-MemoryWeight

指示將記憶體配置到虛擬機器的優先順序，此順序相對於相同主機上的其他虛擬機器。設定較高之虛擬機器配置的記憶體資源，會多於設定較低的虛擬機器。

對於執行 Windows Server 2008 R2 SP1 或更新版本的主機，5000 = Normal、10000 = High、0 = Low、1 到 10000 = Custom。

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

-MergeAnswerFile

指出此 Cmdlet 是否會將回應檔案與客體作業系統設定合併在一起。預設值為 $True。 VMM 控制台會使用此參數。請勿指定此參數。

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

-MonitorMaximumCount

指定虛擬視訊配接器支援的最大監視器數目。

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

-MonitorMaximumResolution

指定值做為字串，代表虛擬視訊配接器的最大可能監視解析度。此參數可接受的值為：

1024 x 768
1280x1024
1600 x 1200
1920x1200

預設值為 1280x1024。

範例格式： -MonitorMaximumResolution "1600x1200"

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

-Name

指定 VMM 物件的名稱。

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

-NetworkUtilizationMbps

指定每秒 mbps (Mbps) ，特定虛擬機可以使用之主機網路上的頻寬量。

範例格式： -NetworkUtilization 10

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

-NumaIsolationRequired

指出是否需要 NUMA 隔離。

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

-NumLock

指出是否要在用來在 Hyper-V 主機上建立虛擬機的範本上啟用 NumLock 的 BIOS 值。此參數不適用於 VMware ESX 主機上或 Citrix XenServer 主機上的虛擬機。

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

-OperatingSystem

指定虛擬機器的作業系統類型。若要列出 VMM 中所有可用作業系統的名稱，請輸入 Get-SCOperatingSystem。

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

-OrganizationName

為註冊虛擬機名稱的人員指定組織名稱。

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

-Owner

以有效網域使用者帳戶的格式指定 VMM 物件的擁有者。

範例格式： -Owner "Contoso\PattiFuller"
範例格式： -Owner "PattiFuller@Contoso"

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

-ProductKey

指定產品金鑰。產品金鑰是識別產品授權的一組 25 位數的數字。產品密鑰可用來註冊 VMM 或要安裝在虛擬機或主機上的作業系統。

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

-ProtectionProvider

指定保護提供者。

Type:	ProtectionProvider
Accepted values:	None, HVR8, HVRBlue, HVRAzure, DiskReplication, SANReplication
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

指定觸發此動作之 PRO 提示 (PRO 提示的標識碼) 。此參數可讓您稽核 PRO 秘訣。

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

-QuotaPoint

指定限制虛擬機自助使用者可以部署的配額。

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

-RecoveryPointObjective

指定因重大事件而無法容忍從IT服務遺失數據的最大期間。

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

-RemoveCapabilityProfile

拿掉一或多個指定的功能配置檔物件。

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

-RemoveDomainJoinOrganizationalUnit

指出此 Cmdlet 會移除電腦在安裝期間加入的組織單位。

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

-RemoveServerFeatures

指出此 Cmdlet 會從範本中移除所有伺服器角色和功能。

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

-ReplicationGroup

指定複寫群組。

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

-RunAsynchronously

表示作業會以異步方式執行，讓控件立即返回命令殼層。

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

-SecureBootEnabled

指出是否啟用安全開機。

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

-SecureBootTemplate

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

-SQLProfile

指定 SQL Server 設定檔物件。

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

-Tag

指定要與物件建立關聯的單字或片語，以便搜尋具有指定標記集的所有物件。您可以搜尋卷標子集，也可以搜尋完整的卷標集。

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

-TimeZone

指定 (索引) 的數位，以識別共用相同標準時間的地理區域。如需時區索引的清單，請參閱位於的 http://go.microsoft.com/fwlink/?LinkId=120935Microsoft 時區索引值。如果未指定時區，則用於虛擬機的預設時區是虛擬機主機上的相同時區設定。

指定 GMT 標準時區的範例格式： -TimeZone 085

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

-UnattendSettings

指定包含 String、 String 的索引鍵/值組。

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

-UpdateManagementProfile

指定可用於 VMTemplate 的 Azure 設定檔。 Azure 設定檔會將 Azure 共同管理功能提供給 VM。

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

-UserRole

指定使用者角色物件。

Type:	UserRole
Aliases:	SelfServiceUserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VirtualNumaNodesPerSocketMaximum

指定每個套接字允許的 NUMA 節點數目上限。

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

-VirtualVideoAdapterEnabled

指出是否要啟用虛擬機的 Microsoft 綜合 3D 虛擬視訊配接器。您可以直接在虛擬機上，或在將用來建立虛擬機的範本或硬體配置檔上啟用虛擬視訊配接器。

必要：只有在執行 Windows Server 2008 R2 SP1 的主機上部署該虛擬機時，才能針對虛擬機啟用 Microsoft 綜合 3D 虛擬視訊配接器 (，且已安裝遠端桌面服務角色和遠端桌面虛擬圖形角色服務) 或更新版本，或是虛擬機儲存在已停止狀態的連結庫中， (儲存虛擬機的硬體變更只能進行如果虛擬機器沒有快照集) 則為。在儲存在連結庫中的虛擬機上啟用 Microsoft 綜合 3D 虛擬視訊配接器，會將該電腦的位置限制為執行 Windows Server 2008 R2 SP1 的主機， (已安裝遠端桌面服務角色和遠端桌面虛擬圖形角色服務) 或更新版本。

範例格式： -VirtualVideoAdapterEnabled $True

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

-VMTemplate

指定用來建立虛擬機器的 VMM 範本物件。

Type:	Template
Aliases:	Template
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Workgroup

在新的或現有的範本、新的或現有的客體作業系統配置檔上，或在新的虛擬機上，指定您要加入虛擬機的工作組名稱。您可以使用這個參數，覆寫範本或來賓作業系統設定檔之現有的值。

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

輸出

Template

此 Cmdlet 會傳回 Template 物件。

備註

需要可使用 Get-SCVMTemplate Cmdlet 擷取的 VMM 虛擬機範本物件。

共用方式為

Set-SCVMTemplate

Syntax

Description

範例

範例 1：指定現有虛擬機範本的記憶體數量

範例 2：為多個高可用性虛擬機範本指定新的擁有者

範例 3：為具有相同擁有者的所有虛擬機範本指定新的擁有者

範例 4：為現有的虛擬機範本啟用易失記憶體

範例 5：指定現有可自定義 Linux 虛擬機範本的根密碼

範例 6：在現有的 VM 範本上啟用 Azure 更新管理功能。

範例 7：停用 VM 範本上的 Azure 更新管理功能。

參數

-AnswerFile

-ApplicationProfile

-AutoLogonCount

-AutoLogonCredential

-AutomaticCriticalErrorAction

-AutomaticCriticalErrorActionTimeout

-BlockDynamicOptimization

-BootOrder

-CapabilityProfile

-CheckpointType

-ClearDRProtection

-ComputerName

-CostCenter

-CPUCount

-CPUExpectedUtilizationPercent

-CPULimitForMigration

-CPULimitFunctionality

-CPUMaximumPercent

-CPUPerVirtualNumaNodeMaximum

-CPURelativeWeight

-CPUReserve

-CPUType

-Custom1

-Custom10

-Custom2

-Custom3

-Custom4

-Custom5

-Custom6

-Custom7

-Custom8

-Custom9

-DeploymentTypeNano

-Description

-DisableAutoLogon

-DiskIops

-Domain

-DomainJoinCredential

-DomainJoinOrganizationalUnit

-DRProtectionRequired

-DynamicMemoryBufferPercentage

-DynamicMemoryEnabled

-DynamicMemoryMaximumMB

-DynamicMemoryMinimumMB

-Enabled

-EnableNestedVirtualization

-FirstBootDevice

-FullName

-GuiRunOnceCommands

-HAVMPriority

-HighlyAvailable

-JobGroup

-JobVariable

-LinuxAdministratorSSHKey

-LinuxAdministratorSSHKeyString

-LinuxDomainName

-LocalAdministratorCredential

-MemoryMB

-MemoryPerVirtualNumaNodeMaximumMB

-MemoryWeight

-MergeAnswerFile

-MonitorMaximumCount

-MonitorMaximumResolution

-Name

-NetworkUtilizationMbps

-NumaIsolationRequired

-NumLock