Set-SCVMTemplate
更改 VMM 中使用的虚拟机模板的属性。
语法
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>]说明
注意
VMM 2019 UR1 及更高版本中包括新参数 [-EnableNestedVirtualization] <布尔> 值。 有关详细信息，请参阅参数。
Set-SCVMTemplate cmdlet 更改 Virtual Machine Manager (VMM) 环境中使用的虚拟机模板的一个或多个属性。
可以更改的属性包括模板名称、其说明、所有者、组织名称、时区、操作系统和产品密钥的设置;BIOS 启动顺序;CPU 数目和特征;分配给虚拟机的主机上的内存量;主机网络上可用于虚拟机的带宽量;使用此模板创建的虚拟机是否具有高可用性 (，即部署在属于主机群集的主机上) ;域或工作组的值以及域凭据;指定自助服务用户可以创建多少个新虚拟机的点配额;自定义字段;和其他选项。
您对模板所做的更改只会对该模板产生影响。 更改不会影响以前使用此模板创建的任何现有虚拟机。
如果要更改虚拟磁盘驱动器的属性， 虚拟软盘驱动器、虚拟 DVD 驱动器、虚拟网络适配器、虚拟 SCSI 适配器或与特定模板关联的虚拟 COM 端口，可以分别使用 Set-SCVirtualDiskDrive、 Set-SCVirtualFloppyDrive、 Set-SCVirtualDVDDrive、 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 变量中。
最后一个命令将 root 帐户密码设置为存储在 $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。 每个虚拟机最多 4 个 CPU，具体取决于来宾操作系统。
- VMware ESX。 每个虚拟机最多 4 个 CPU，但运行 Windows NT 4.0 的虚拟机上只有一个 CPU。
- Citrix XenServer。 每个虚拟机最多 8 个 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
指示是通过为虚拟机提供有限的 CPU 功能，在部署在 Hyper-V 主机或 VMware ESX 主机上的虚拟机上启用运行较旧的操作系统（如 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
{{Fill DeploymentTypeNano Description}}
| 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
指定有权将计算机加入域的帐户的用户名和密码。 建议使用将计算机加入域的有限权限帐户。 这包括虚拟计算机和物理计算机。
可以使用 current 参数在 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。
必需：仅当虚拟机部署在运行 Windows Server 2008 R2 SP1 或更高版本的主机上时，或者如果虚拟机存储在处于停止状态的库中， (仅当虚拟机没有快照) 时，才能为虚拟机启用动态内存。 如果对存储在库中的虚拟机启用动态内存，则会将该虚拟机的放置局限于运行 Windows Server 2008 R2 SP1 或更高版本的主机。
示例格式： -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 分配给转换后的虚拟机的主机上 (RAM) 的随机访问内存量（以 MB (MB) 为单位）。 默认值为 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 = 正常，10000 = 高，0 = 低，1 到 10000 = 自定义。
| 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) 。
示例格式： -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 提示) 的 ID。 此参数允许你审核 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=120935的 Microsoft 时区索引值。
如果未指定时区，则用于虚拟机的默认时区与虚拟机主机上的时区设置相同。
指定 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 配置文件为 VM 提供 Azure 共同管理功能。
| 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 Synthetic 3D 虚拟视频适配器。 可以直接在虚拟机上或者用于创建虚拟机的模板或硬件配置文件上启用虚拟视频适配器。
必需：仅当虚拟机部署在运行 Windows Server 2008 R2 SP1 (且远程桌面服务角色和远程桌面虚拟图形角色服务的主机上时，才能为虚拟机启用 Microsoft Synthetic 3D 虚拟视频适配器) 或更高版本，或者如果虚拟机存储在处于停止状态的库中， (只能对存储的虚拟机进行硬件更改如果虚拟机没有) 快照，则为 。 在库中存储的虚拟机上启用 Microsoft Synthetic 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 对象。
备注
- 需要 VMM 虚拟机模板对象，可以使用 Get-SCVMTemplate cmdlet 检索该对象。