Set-SCVMTemplate

Ссылка

Модуль:: VirtualMachineManager

Изменяет свойства шаблона виртуальной машины, используемого в 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>]

Описание

Примечание

Новый параметр [-EnableNestedVirtualization] включен в VMM 2019 UR1. Дополнительные сведения см. в разделе Параметры.

Командлет Set-SCVMTemplate изменяет одно или несколько свойств шаблона виртуальной машины, используемого в среде Virtual Machine Manager (VMM).

Свойства, которые можно изменить, включают параметры для имени шаблона, его описания, владельца, имени организации, часового пояса, операционной системы и ключа продукта; Порядок загрузки BIOS; Число ЦП и характеристики; объем памяти на узле, назначенном виртуальной машине; объем пропускной способности в сети узла, доступной виртуальной машине; будет ли виртуальная машина, созданная с помощью этого шаблона, будет высокодоступна (т. е. развернута на узле, который является частью кластера узлов); значения для домена или рабочей группы, а также учетные данные домена; квота точки, указывающая, сколько новых виртуальных машин могут создавать пользователи самообслуживания; настраиваемые поля; и другие параметры.

Изменения, внесенные в шаблон, влияют только на шаблон. Изменения не влияют на существующие виртуальные машины, созданные ранее с помощью этого шаблона.

Если вы хотите изменить свойства виртуального диска, виртуальный диск floppy, виртуальный DVD-диск, виртуальный сетевой адаптер, виртуальный адаптер SCSI или виртуальный COM-порт, связанный с определенным шаблоном, можно использовать командлеты Set-SCVirtualDiskDrive, Set-SCVirtualFloppyDrive,Set-SCVirtualNetworkAdapter, Set-SCVirtualScsiAdapter или Set-SCVirtualCOMPort соответственно.

Примеры

Пример 1. Указание объема памяти для существующего шаблона виртуальной машины

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

Первая команда получает объект шаблона виртуальной машины с именем VMTemplate01 из библиотеки VMM и сохраняет объект в переменной $Template.

Вторая команда изменяет значение памяти для VMTemplate01 на 1024 МБ. Это объем памяти на узле, который будет использоваться виртуальной машиной, созданной с помощью этого шаблона.

Пример 2. Указание нового владельца для нескольких шаблонов виртуальных машин с высоким уровнем доступности

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

Первая команда получает все объекты шаблона виртуальной машины с высоким уровнем доступности и сохраняет объекты в массиве объектов $VMTemplates.

Вторая команда использует цикл ForEach , чтобы указать нового владельца для каждого шаблона в массиве $VMTemplates.

Для получения сведений о стандартной инструкции цикла ForEach PowerShell введите 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 , который изменяет владельца на Contoso| АллиСлоан.

Пример 4. Включение динамической памяти для существующего шаблона виртуальной машины

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

Первая команда получает объект шаблона виртуальной машины с именем VMTemplate04 из библиотеки VMM и сохраняет объект в переменной $VMTemplate.

Вторая команда включает динамическую память, изменяет значение памяти запуска для VMTemplate04 на 1024 МБ (это объем памяти на узле, который виртуальная машина, созданная с помощью этого шаблона, выделяется при запуске), и задает максимальное значение памяти 2048 МБ (это максимальный объем памяти, который можно выделить виртуальной машине, созданной с помощью этого шаблона). Виртуальную машину, использующую динамическую память, можно развернуть только на узле под управлением Windows Server 2008 R2 с пакетом обновления 1 (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

Первая команда получает объект шаблона виртуальной машины с именем LinuxVMTemplate01 из библиотеки VMM и сохраняет объект в переменной $Template.

Вторая команда получает имя пользователя (корневой) и пароль с помощью команды Get-Credential и сохраняет результат в переменной $Creds.

Последняя команда задает пароль корневой учетной записи для пароля, хранящегося в переменной $Creds.

Пример 6. Включение возможностей управления обновлениями 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

Вторая команда получает профиль управления обновлениями Azure из библиотеки VMM и сохраняет объект в переменной $azureProfile.

Третья команда включает шаблон с возможностями управления обновлениями Azure путем связывания профиля Azure.

Пример 7. Отключение возможностей управления обновлениями Azure на шаблоне виртуальной машины.

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

Вторая команда отключает шаблон с возможностями управления обновлениями 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
Floppy

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
Standard

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

-ClearDRProtection

Указывает, что этот командлет сбрасывает параметр защиты от аварийного восстановления.

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

-ComputerName

Указывает имя компьютера, который VMM может однозначно идентифицировать в сети. Допустимые значения для этого параметра:

Полное доменное имя.
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

Указывает количество ЦП на виртуальной машине, в профиле оборудования или в шаблоне.

Типы узлов поддерживают следующее количество ЦП:

Hyper-V. До четырех ЦП на виртуальную машину в зависимости от гостевой операционной системы.
VMware ESX. До четырех ЦП на виртуальную машину, но только один ЦП на виртуальной машине, на которой выполняется Windows NT 4.0.
Citrix XenServer. До восьми ЦП на виртуальную машину в зависимости от гостевой операционной системы.

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

-CPUExpectedUtilizationPercent

Указывает процент ЦП на узле, который будет использоваться этой виртуальной машиной. Это значение используется только в том случае, если 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

Указывает, следует ли включить запуск более старой операционной системы, например Windows NT 4.0 на виртуальной машине, развернутой на узле Hyper-V или на узле VMware ESX, предоставляя ограниченные функциональные возможности ЦП для виртуальной машины.

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

-CPUMaximumPercent

Указывает наибольший процент общих ресурсов одного ЦП на узле, который может использоваться определенной виртуальной машиной в любой момент времени.

Пример: -CPUMaximumPercent 80 (для указания 80 процентов)

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

-CPUPerVirtualNumaNodeMaximum

Указывает максимальное число ЦП, разрешенных для каждого виртуального узла NUMA.

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

-CPURelativeWeight

Указывает объем ресурсов ЦП на узле, который эта виртуальная машина может использовать относительно других виртуальных машин на том же узле. Виртуальная машина с более высоким весом выделяет больше ресурсов ЦП, чем виртуальная машина с меньшим весом. Термин 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

Указывает минимальный процент ресурсов одного ЦП на узле, выделяемых виртуальной машине. Процент емкости ЦП, доступной для виртуальной машины, никогда не меньше этого процента.

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

-CPUType

Указывает тип ЦП для виртуальной машины. Чтобы получить список всех типов ЦП, доступных для использования на виртуальных машинах в среде VMM, введите Get-SCCPUType.

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