Set-SCVMConfiguration

Модуль:
VirtualMachineManager Module

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

Синтаксис

Update (по умолчанию) 

Set-SCVMConfiguration
    [-VMConfiguration] <BaseVMConfiguration>
    [-VMLocation <String>]
    [-PinVMLocation <Boolean>]
    [-ComputerName <String>]
    [-PinVMHost <Boolean>]
    [-CapabilityProfile <CapabilityProfile>]
    [-VMMServer <ServerConnection>]
    [-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>]

VMHost 

Set-SCVMConfiguration
    [-VMConfiguration] <BaseVMConfiguration>
    -VMHost <Host>
    [-VMLocation <String>]
    [-PinVMLocation <Boolean>]
    [-ComputerName <String>]
    [-PinVMHost <Boolean>]
    [-CapabilityProfile <CapabilityProfile>]
    [-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>]

VMHostGroup 

Set-SCVMConfiguration
    [-VMConfiguration] <BaseVMConfiguration>
    [-VMLocation <String>]
    [-PinVMLocation <Boolean>]
    [-ComputerName <String>]
    [-PinVMHost <Boolean>]
    [-VMHostGroup <HostGroup>]
    [-CapabilityProfile <CapabilityProfile>]
    [-VMMServer <ServerConnection>]
    [-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>]

Cloud 

Set-SCVMConfiguration
    [-VMConfiguration] <BaseVMConfiguration>
    -Cloud <Cloud>
    [-VMLocation <String>]
    [-PinVMLocation <Boolean>]
    [-ComputerName <String>]
    [-PinVMHost <Boolean>]
    [-CapabilityProfile <CapabilityProfile>]
    [-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.

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

Последняя команда задает для параметра 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]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CapabilityProfile

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

Свойства параметра

Тип:CapabilityProfile
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Cloud

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

Свойства параметра

Тип:Cloud
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Cloud
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ComputerName

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

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CostCenter

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JobVariable

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-NoConnectedHost

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OnBehalfOfUser

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OnBehalfOfUserRole

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

Свойства параметра

Тип:UserRole
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PinVMHost

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PinVMLocation

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PROTipID

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

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RunAsynchronously

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Tag

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMConfiguration

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

Свойства параметра

Тип:BaseVMConfiguration
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMHost

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

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

Свойства параметра

Тип:Host
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VMHost
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMHostGroup

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

Свойства параметра

Тип:HostGroup
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VMHostGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMLocation

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMMServer

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

Свойства параметра

Тип:ServerConnection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Update
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
VMHostGroup
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

VMConfiguration

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