Set-SCVirtualMachine

Ссылка

Модуль:: VirtualMachineManager

Изменяет свойства виртуальной машины, управляемой VMM.

Синтаксис

Set-SCVirtualMachine
   [-VM] <VM>
   [-VMwareResourcePool <VmwResourcePool>]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-RemoveSelfServiceUserRole <Boolean>]
   [-EnableOperatingSystemShutdown <Boolean>]
   [-EnableTimeSync <Boolean>]
   [-EnableDataExchange <Boolean>]
   [-EnableHeartbeat <Boolean>]
   [-EnableBackup <Boolean>]
   [-InstallVirtualizationGuestServices <Boolean>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-VMShieldingData <KeyFile>]
   [-RunAsSystem]
   [-RunAsUserCredential <PSCredential>]
   [-DelayStartSeconds <Int32>]
   [-UseHardwareAssistedVirtualization <Boolean>]
   [-Cloud <Cloud>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-RemoveFromCloud]
   [-ClusterNonPossibleOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-ClusterPreferredOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-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>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Описание

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

К свойствам, которые можно изменить, относятся следующие:

Свяжите виртуальную машину с облаком.
Имя, владелец и описание виртуальной машины.
Порядок загрузки BIOS, если виртуальная машина развернута на узле Hyper-V.
Объем ресурсов на узле, используемом виртуальной машиной. следующие основные параметры.
Максимальный объем ресурсов ЦП узла, которые может использовать виртуальная машина.
Ожидаемое использование ЦП узла виртуальной машиной.
Объем ресурсов ЦП узла, используемых одной виртуальной машиной относительно других виртуальных машин на том же узле.
Объем памяти узла, который может использовать виртуальная машина.
Объем пропускной способности в сети узла, которую может использовать виртуальная машина.
Параметры оборудования для виртуальной машины, не связанной с ресурсами узла. следующие основные параметры.
Количество ЦП.
Тип ЦП.
Количество операций ввода-вывода диска в секунду (ioPS).
Ограничение функциональных возможностей ЦП для более старой операционной системы, например Windows NT 4.0.
Центр затрат, тег и пользовательские параметры, используемые для фильтрации виртуальных машин по критериям.
Параметры, обеспечивающие различные необязательные возможности, которые включают следующие:
Включение или отключение объекта библиотеки, чтобы сделать его доступным или временно недоступным для пользователей.
Включение резервного копирования виртуальной машины на узле Hyper-V с помощью службы теневого копирования томов.
Включение пары "ключ—значение" для обмена данными между виртуальной машиной и узлом Hyper-V.
Включение завершения работы виртуальной машины из консоли Hyper-V.
Включение синхронизации времени между виртуальной машиной и его узлом Hyper-V.
Включение значения BIOS для NumLock для виртуальной машины на узле Hyper-V.
Параметр, определяющий, является ли виртуальная машина высокодоступной, то есть виртуальная машина, которая будет развернута на узле кластера узлов Hyper-V или кластера узлов Citrix XenServer.
Параметр, определяющий, установлены ли гостевые службы виртуализации на виртуальной машине, развернутой на узле Hyper-V.
Время задержки в секундах перед запуском виртуальной машины.
Параметр, определяющий операционную систему, используемую для виртуальной машины.
Запуск и остановка действий для виртуальной машины.
Настройка, ограничивающая количество создаваемых пользователей самообслуживания виртуальных машин.
Параметр, используемый для переключения роли, которую пользователь самообслуживания, принадлежащий нескольким ролям, использует для управления виртуальной машиной.
Параметр, который назначает виртуальную машину на узле ESX пулу ресурсов VMware.

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

Примеры

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

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> If($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -MemoryMB 1024

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

Второй определяет, находится ли виртуальная машина, хранящуюся в $VM, в отключенном состоянии. Если виртуальная машина не находится в отключенном состоянии, команда использует команду Stop-SCVirtualMachine для отключения виртуальной машины. Дополнительные сведения о выключении виртуальной машины введите Get-Help Stop-SCVirtualMachine.

Последняя команда изменяет память, выделенную для VM01, на 1024 МБ.

Пример 2. Изменение роли пользователя, используемой для управления виртуальной машиной для пользователя, который принадлежит нескольким ролям пользователей самообслуживания

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" -Name "VM02"
PS C:\> $SSRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCVirtualMachine -VM $VM -UserRole $SSRole

Первая команда получает объект виртуальной машины с именем VM02 из VMMServer01, а затем сохраняет этот объект в переменной $VM.

Вторая команда получает объект роли пользователя с именем ContosoSelfServiceUsers, а затем сохраняет объект в переменной $SSRole.

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

Примечание. VMM использует параметр UserRole для задания виртуальных машин, которыми управляют члены определенной роли пользователя самообслуживания. Как правило, для настройки этого параметра не требуется использовать командлет Set-SCVirtualMachine с параметром UserRole . Однако если один или несколько пользователей являются членами нескольких ролей пользователей самообслуживания и вы предоставляете им разрешение на управление несколькими виртуальными машинами на одном узле, может возникнуть случай, когда вы хотите переключить роль пользователя, которой разрешено управлять конкретной виртуальной машиной. Этот пример иллюстрирует этот сценарий.

Пример 3. Отключение синхронизации времени на виртуальной машине, используемой в качестве контроллера домена

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "STOP"
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> trap{"Fail: Cannot disable Time Synchronization for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -EnableTimeSynchronization $TRUE | Out-Null
PS C:\> $ErrorActionPreference = $EAP

Первая команда сохраняет текущий параметр для $ErrorActionPreference в переменной $EAP. Эта переменная используется позже для возврата параметра в исходное значение.

Вторая команда задает для действия значение STOP. Этот параметр действия ошибки изменяет ошибку из неустранимой ошибки на завершающее ошибку. Объект ошибки вызывается как исключение, а не записывается в выходной канал, и команда не продолжает выполняться.

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

Четвертая команда отключает параметр синхронизации времени. Как правило, отключение синхронизации времени требуется для виртуальных машин, которые выполняют роль контроллеров домена. Команда использует оператор trap для перехвата завершающих исключений. Если команда Set-SCVirtualMachine завершается ошибкой, отображается строка в инструкции trap . Оператор continue используется в инструкции trap для продолжения выполнения вместо выхода. Командлет Out-Null перенаправляет выходные данные в $Null вместо отправки в консоль.

Последняя команда задает значение $ErrorActionPreference значением, хранящимся в $EAP.

Пример 4. Настройка порядка запуска устройства для всех виртуальных машин, поддерживающих эту функцию

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "Stop"
PS C:\> $VMs = @(Get-SCVirtualMachine)
PS C:\> ForEach($VM in $VMs){trap{"Fail: Cannot set BIOS for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -BootOrder "PXEBoot","IDEHarddrive","CD","Floppy" | Out-Null}
PS C:\> $ErrorActionPreference = $EAP

Первая команда сохраняет текущий параметр для $ErrorActionPreference в $EAP. Эта переменная используется позже для возврата параметра в исходное значение.

Вторая команда задает для действия ошибки значение Stop. Этот параметр действия ошибки изменяет ошибку из неустранимой ошибки на завершающее ошибку. Объект ошибки вызывается как исключение, а не записывается в выходной канал, и команда не продолжает выполняться.

Третья команда получает каждый объект виртуальной машины, в котором хранятся объекты в $VMs. Использование символов @ и скобок гарантирует, что команда сохраняет результаты в массиве, если команда возвращает один объект или значение NULL.

Четвертая команда устанавливает порядок загрузки BIOS для каждой виртуальной машины в PXEBoot, IDEHarddrive, CD, Floppy. Команда использует оператор trap для перехвата завершающих исключений. Если команда Set-SCVirtualMachine завершается ошибкой, отображается строка в инструкции trap. Оператор continue используется в инструкции trap для продолжения выполнения вместо выхода из цикла ForEach . Командлет Out-Null перенаправляет выходные данные в $Null вместо отправки в консоль.

Примечание. Параметр BootOrder используется только для виртуальных машин на узлах Hyper-V и Citrix XenServer. Он не используется для виртуальных машин на узлах VMware ESX. Узлы XenServer не поддерживают гибкие диски и, следовательно, игнорируют Floppy, если они указаны в порядке загрузки.

Последняя команда задает значение $ErrorActionPreference значением, хранящимся в EAP.

Дополнительные сведения о стандартной инструкции цикла Windows PowerShell ForEach введите Get-Help about_ForEach.

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

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

Эта команда получает все объекты виртуальных машин в VMMServer01, выбирает только те объекты виртуальных машин, в которых нет владельца, и указывает владельца для каждой виртуальной машины.

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

PS C:\> $VM = Get-SCVirtualMachine -Name "VM06"
PS C:\> if($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

Первая команда получает объект виртуальной машины VM06 и сохраняет этот объект в переменной $VM. Чтобы включить динамическую память на виртуальной машине, виртуальная машина должна находиться на узле под управлением Windows Server 2008 R2 с пакетом обновления 1 (SP1) или более поздней версии.

Вторая команда определяет, находится ли виртуальная машина, хранящейся в $VM, находится в отключенном состоянии. Если виртуальная машина не находится в отключенном состоянии, команда использует команду Stop-SCVirtualMachine для отключения виртуальной машины.

Последняя команда включает динамическую память, устанавливает для памяти запуска значение 1024 МБ и задает максимальный объем памяти 2048 МБ. Память запуска — это объем памяти на узле, выделенном для VM06 при запуске. Максимальный объем памяти — это максимальный объем памяти на узле, выделенном для VM06.

Параметры

-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

-AvailabilitySetNames

Указывает список имен групп доступности.

Type:	System.Collections.Generic.List`1[System.String]
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

-Cloud

Указывает объект частного облака.

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

-ClusterNonPossibleOwner

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

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterPreferredOwner

Задает список имен предпочтительных владельцев узлов кластера для конкретной виртуальной машины.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
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

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

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

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