Set-SCVMConfiguration

Модуль:

VirtualMachineManager

Изменяет конфигурацию виртуальной машины для уровня компьютера.

Синтаксис

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   -VMHost <Host>
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-VMHostGroup <HostGroup>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   -Cloud <Cloud>
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Описание

Командлет set-SCVMConfiguration изменяет конфигурацию виртуальной машины для уровня компьютера. Конфигурация виртуальной машины описывает, как будет настроена виртуальная машина при развертывании службы.

Примеры

Пример 1. Обновление конфигурации виртуальной машины для уровня компьютера перед развертыванием службы

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"

Первая команда получает объект конфигурации службы с именем Service01 и сохраняет объект в переменной $ServiceConfig.

Вторая команда получает конфигурацию уровня компьютера для конфигурации службы, хранящейся в $ServiceConfig, и сохраняет объект в переменной $TierConfig.

Третья команда получает конфигурацию виртуальной машины для конфигурации уровня компьютера, хранящейся в $TierConfig, и сохраняет переменную в переменной $VMConfig.

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

Пример 2. Настройка объекта конфигурации виртуальной машины для уровня компьютера для закрепления узла для виртуальной машины

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $True

Первая команда получает объект конфигурации службы с именем Service01 и сохраняет объект в переменной $ServiceConfig.

Вторая команда получает объект конфигурации уровня компьютера для конфигурации службы, хранящейся в $ServiceConfig, и сохраняет объект в переменной $TierConfig.

Третья команда получает объекты конфигурации виртуальной машины для конфигурации уровня компьютера, хранящейся в $TierConfig, и сохраняет объекты в переменной $VMConfig.

Последняя команда задает propety PinVMHost $True для первого объекта конфигурации виртуальной машины, хранящегося в $VMConfig. Поэтому при развертывании службы узел виртуальной машины, созданной с этой конфигурацией, не будет изменен.

Пример 3. Настройка объекта конфигурации виртуальной машины для службы в частном облаке

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"

Первая команда получает объект конфигурации службы с именем Service01 и сохраняет объект в переменной $ServiceConfig.

Вторая команда получает конфигурацию уровня компьютера для конфигурации службы, хранящейся в $ServiceConfig, и сохраняет объект в переменной $TierConfig.

Третья команда получает объекты конфигурации виртуальной машины для конфигурации уровня компьютера, хранящейся в $TierConfig, и сохраняет объекты в переменной $VMConfig.

Четвертая команда получает объект частного облака с именем Production и сохраняет объект в переменной $Cloud.

Последняя команда обновляет описание второго объекта конфигурации виртуальной машины, хранящегося в $VMConfig для частного облака, хранящегося в $Cloud.

Параметры

-AvailabilitySetNames

Задает список имен групп доступности.

Тип:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CapabilityProfile

Указывает объект профиля возможностей.

Тип:	CapabilityProfile
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Cloud

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

Тип:	Cloud
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ComputerName

Указывает имя компьютера, который Virtual Machine Manager (VMM) может однозначно идентифицировать в сети. Допустимые форматы:

• Полное доменное имя
• IPv4 или IPv6-адрес
• Имя NetBIOS

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CostCenter

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Description

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-JobVariable

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Указывает имя объекта VMM.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NoConnectedHost

Удаляет узел из конфигурации виртуальной машины.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OnBehalfOfUser

Указывает имя пользователя. Этот командлет задает от имени пользователя, указанного этим параметром.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OnBehalfOfUserRole

Указывает роль пользователя. Этот командлет задает от имени роли пользователя роль пользователя в качестве роли пользователя, указанной этим параметром. Чтобы получить объект роли пользователя, используйте командлет Get-SCUserRole.

Тип:	UserRole
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PinVMHost

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

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PinVMLocation

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

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.

Тип:	Guid
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RunAsynchronously

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Tag

Указывает слово или фразу для связывания с объектом, чтобы можно было искать все объекты с указанным набором тегов. Можно найти подмножество тегов или найти полный набор тегов.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VMConfiguration

Указывает объект конфигурации виртуальной машины.

Тип:	BaseVMConfiguration
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-VMHost

Указывает объект узла виртуальной машины. VMM поддерживает узлы Hyper-V, узлы VMware ESX и узлы Citrix XenServer.

Дополнительные сведения о каждом типе узла см. в командлете Add-SCVMHost.

Тип:	Host
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VMHostGroup

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

Тип:	HostGroup
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VMLocation

Указывает путь к виртуальной машине.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VMMServer

Указывает объект сервера VMM.

Тип:	ServerConnection
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Выходные данные

VMConfiguration

Этот командлет возвращает объект VMConfiguration.

Связанные ссылки

• Get-SCComputerTierConfiguration
• Get-SCServiceConfiguration
• Get-SCVMConfiguration
• New-SCVMConfiguration
• Remove-SCVMConfiguration
• Update-SCVMConfiguration