Прочитать на английском

Поделиться через

Set-SCCustomProperty

  • Ссылка
Модуль:
VirtualMachineManager

Изменяет свойства настраиваемого свойства.

Синтаксис

Set-SCCustomProperty
   [-VMMServer <ServerConnection>]
   -CustomProperty <CustomProperty>
   [-Name <String>]
   [-Description <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCCustomProperty
   [-VMMServer <ServerConnection>]
   -CustomProperty <CustomProperty>
   [-Name <String>]
   [-Description <String>]
   -AddMember <CustomPropertyObjectType[]>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCCustomProperty
   [-VMMServer <ServerConnection>]
   -CustomProperty <CustomProperty>
   [-Name <String>]
   [-Description <String>]
   -RemoveMember <CustomPropertyObjectType[]>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Описание

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

  • Описание настраиваемого свойства
  • Имя настраиваемого свойства
  • Добавление члена в пользовательское свойство
  • Удаление элемента из настраиваемого свойства

Сведения о создании пользовательского свойства введите Get-Help New-SCCustomProperty -Detailed.

Примеры

Пример 1. Добавление элемента в пользовательское свойство

PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -AddMember "VMHost"

Первая команда получает объект пользовательского свойства с именем Cost Center и сохраняет объект в переменной $CustomProp.

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

Пример 2. Удаление элемента из настраиваемого свойства

PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -RemoveMember "VM"

Первая команда получает объект пользовательского свойства с именем Cost Center и сохраняет объект в переменной $CustomProp.

Вторая команда удаляет член виртуальной машины из объекта пользовательского свойства, хранящегося в $CustomProp.

Параметры

-AddMember

Указывает массив элементов, которые этот командлет добавляет в объект, имеющий концепцию членов, например группу. Например, этот командлет может добавить одного или нескольких доменных пользователей или групп доменных служб Active Directory® в роль пользователя. Укажите элементы в следующих форматах:

  • Домен\Пользователь
  • Пользователь
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

Псевдоним группы лабораторий — это группа безопасности доменных служб Active Directory, а не псевдоним электронной почты.

Тип:CustomPropertyObjectType[]
Допустимые значения:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CustomProperty

Указывает объект пользовательского свойства.

Тип:CustomProperty
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки: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

-PROTipID

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

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

-RemoveMember

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

  • Домен\Пользователь
  • Пользователь
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

Псевдоним группы лабораторий — это группа безопасности доменных служб Active Directory, а не псевдоним электронной почты.

Тип:CustomPropertyObjectType[]
Допустимые значения:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunAsynchronously

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

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

-VMMServer

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

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