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

New-CMOrchestrationGroup

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

Создайте новую группу оркестрации.

Синтаксис

New-CMOrchestrationGroup
   [-Name] <String>
   -SiteCode <String>
   [-Description <String>]
   -OrchestrationType <OrchestrationTypeValue>
   [-OrchestrationValue <Int32>]
   [-OrchestrationTimeOutMin <Int32>]
   [-MaxLockTimeOutMin <Int32>]
   [-PreScript <String>]
   [-PreScriptTimeoutSec <Int32>]
   [-PostScript <String>]
   [-PostScriptTimeoutSec <Int32>]
   -MemberResourceIds <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Используйте группы оркестрации для более эффективного управления развертыванием обновлений программного обеспечения на устройствах. Возможно, вам потребуется тщательно управлять обновлениями для определенных рабочих нагрузок или автоматизировать поведение между ними. Дополнительные сведения см. в статье Создание и использование групп оркестрации в Configuration Manager.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1

В этом примере сначала параметры командлета объединяются в переменную parameters . Это не обязательно для splat параметры, это просто упрощает чтение параметров для такой длинной командной строки.

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

Команда создает группу оркестрации с параметрами по умолчанию и простыми скриптами для тестирования.

$parameters = @{
  Name = "IT servers"
  SiteCode = "XYZ"
  Description = "An OG for IT servers with default settings"
  OrchestrationType = "Number"
  OrchestrationValue = 1
  OrchestrationTimeOutMin = 720
  MaxLockTimeOutMin = 60
  PreScript = "Write-Host 'Pre-install script'"
  PreScriptTimeoutSec = 120
  PostScript = "Write-Host 'POST-install script'"
  PostScriptTimeoutSec = 120
  MemberResourceIds = $device1.ResourceID, $device2.ResourceID
}

New-CMOrchestrationGroup @parameters

Параметры

-Confirm

Перед запуском командлет запросит подтверждение.

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

-Description

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

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

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

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

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

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

-MaxLockTimeOutMin

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

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

-MemberResourceIds

Укажите массив идентификаторов ресурсов для устройств, добавляемых в качестве членов этой группы оркестрации. Идентификатор ресурса — это целое число, например 16777220. Это свойство ResourceId на устройстве или объекте ресурса. Чтобы получить объект устройства, используйте командлеты Get-CMDevice или Get-CMResource .

Если для параметра OrchestrationType задано значение Sequence, используйте этот параметр для определения порядка.

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

-Name

Укажите имя группы оркестрации.

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

-OrchestrationTimeOutMin

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

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

-OrchestrationType

Укажите одно из следующих значений для типа группы оркестрации:

  • Number: разрешить одновременное обновление нескольких устройств. Используйте этот параметр, чтобы всегда ограничивать определенное количество устройств независимо от общего размера группы оркестрации. Чтобы указать количество устройств, используйте параметр OrchestrationValue .

  • Percentage: разрешить одновременное обновление определенной части устройств. Используйте этот параметр, чтобы обеспечить гибкость размера группы оркестрации в будущем. Чтобы указать процент, используйте параметр OrchestrationValue .

  • Sequence: явно определите порядок, в котором устройства выполняют развертывание обновлений программного обеспечения. Порядок определяется типом идентификаторов ресурсов устройства в параметре MemberResourceIds .

Тип:OrchestrationTypeValue
Допустимые значения:Number, Percentage, Sequence
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OrchestrationValue

Укажите целое число для количества или процента устройств, обновляемых одновременно. Используйте этот параметр, если для параметра OrchestrationType задано значение Number или Percentage.

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

-PostScript

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

Это строковое значение является текстом самого скрипта. Если в файле есть скрипт, который вы хотите использовать, сначала считайте его в переменную. Например, используйте встроенный командлет Get-Content .

Скрипты должны возвращать значение для успешного 0 выполнения. Любое ненулевое значение считается сбоем скрипта. Нельзя использовать скрипт с параметрами. Максимальная длина скрипта — 50 000 символов.

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

-PostScriptTimeoutSec

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

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

-PreScript

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

Это строковое значение является текстом самого скрипта. Если в файле есть скрипт, который вы хотите использовать, сначала считайте его в переменную. Например, используйте встроенный командлет Get-Content .

Скрипты должны возвращать значение для успешного 0 выполнения. Любое ненулевое значение считается сбоем скрипта. Нельзя использовать скрипт с параметрами. Максимальная длина скрипта — 50 000 символов.

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

-PreScriptTimeoutSec

Укажите целочисленное значение для допустимого времени в секундах для выполнения предварительного скрипта до истечения времени ожидания.

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

-SiteCode

Укажите код сайта для этой группы оркестрации и ее членов.

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

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

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

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

None

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

IResultObject

Примечания

Этот командлет возвращает объект для класса WMI SMS_MachineOrchestrationGroup .