New-CMOrchestrationGroup
Создайте новую группу оркестрации.
Синтаксис
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 .