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|艾莉斯隆
示例 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。 每个虚拟机最多 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 资源比权重较低的虚拟机分配的 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
指定有权将计算机加入域的帐户的用户名和密码。 建议使用将计算机加入域的有限权限帐户。 这包括虚拟计算机和物理计算机。
可以使用当前参数在 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 (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 (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
指示作业以异步方式运行，以便控件立即返回到命令 shell。
| 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
指定一个数字 (索引) ，该索引标识共享同一标准时间的地理区域。
有关时区索引的列表，请参阅 Microsoft 时区索引值。http://go.microsoft.com/fwlink/?LinkId=120935
如果未指定时区，则用于虚拟机的默认时区是虚拟机主机上的同一时区设置。
指定 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 合成 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 对象。
备注
- 需要 VMM 虚拟机模板对象，可以使用 Get-SCVMTemplate cmdlet 进行检索。