Set-SCVMConfiguration
Изменяет конфигурацию виртуальной машины для уровня компьютера.
Синтаксис
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.
Последняя команда задает свойство 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.
Последняя команда задает 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
Указывает список имен групп доступности.
| Type: | System.Collections.Generic.List`1[System.String] |
| 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 |
-Cloud
Указывает объект частного облака.
| Type: | Cloud |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Указывает имя компьютера, который Virtual Machine Manager (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 |
-Description
Указывает описание конфигурации.
| Type: | String |
| 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 |
-Name
Указывает имя объекта VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoConnectedHost
Удаляет узел из конфигурации виртуальной машины.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Указывает имя пользователя. Этот командлет задает от имени пользователя, указанного этим параметром.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Указывает роль пользователя. Этот командлет задает роль пользователя от имени в качестве роли пользователя, указанной этим параметром. Чтобы получить объект роли пользователя, используйте командлет Get-SCUserRole .
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinVMHost
Указывает, сохраняется ли узел виртуальной машины, выбранный пользователем, во время настройки развертывания службы.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PinVMLocation
Указывает, сохраняется ли расположение виртуальной машины, выбранное пользователем, во время настройки развертывания службы.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проводить аудит советов PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Указывает, что задание выполняется асинхронно, чтобы управление немедленно возвращалось в командную оболочку.
| Type: | SwitchParameter |
| 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 |
-VMConfiguration
Указывает объект конфигурации виртуальной машины.
| Type: | BaseVMConfiguration |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMHost
Указывает объект узла виртуальной машины. VMM поддерживает узлы Hyper-V, узлы VMware ESX и узлы Citrix XenServer.
Дополнительные сведения о каждом типе узла см. в командлете Add-SCVMHost .
| Type: | Host |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
Указывает объект группы узлов виртуальной машины или массив объектов группы узлов.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMLocation
Указывает путь к виртуальной машине.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Указывает объект сервера VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Выходные данные
VMConfiguration
Этот командлет возвращает объект VMConfiguration .