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>] 说明
使用此 cmdlet 创建新的业务流程组。
使用业务流程组可以更好地控制软件更新到设备的部署。 可能需要仔细管理特定工作负载的更新，或自动执行两者之间的行为。 有关详细信息，请参阅 在 Configuration Manager 中创建和使用业务流程组。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1
此示例首先将 cmdlet 参数 Splats 到 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
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
为业务流程组指定可选说明以帮助识别它。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-MaxLockTimeOutMin
指定业务流程组成员超时的整数值（以分钟为单位）。 此值是组中单个设备安装更新的时间限制。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-MemberResourceIds
指定要添加为此业务流程组成员的设备的资源 ID 数组。 资源 ID 是整数，例如 16777220。 它是设备或资源对象上的 ResourceId 属性。 若要获取设备对象，请使用 Get-CMDevice 或 Get-CMResource cmdlet。
将 OrchestrationType 参数设置为 Sequence时，使用此参数确定顺序。
| 类型: | Int32[] |
| 别名: | MogMembers |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定业务流程组的名称。
| 类型: | String |
| 别名: | OrchestrationGroupName |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-OrchestrationTimeOutMin
指定业务流程组超时的整数值（以分钟为单位）。 此值是所有组成员安装更新的时间限制。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-OrchestrationType
为业务流程组的类型指定以下值之一：
Number：允许同时更新多个设备。 使用此设置始终限制为特定数量的设备，无论业务流程组的总体大小如何。 若要指定设备数，请使用 OrchestrationValue 参数。Percentage：允许一定比例的设备同时更新。 使用此设置可以灵活调整业务流程组的大小。 若要指定百分比，请使用 OrchestrationValue 参数。Sequence：显式定义设备运行软件更新部署的顺序。 顺序由 MemberResourceIds 参数中的设备资源 ID 的排序决定。
| 类型: | OrchestrationTypeValue |
| 接受的值: | Number, Percentage, Sequence |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-OrchestrationValue
为要同时更新的设备数或百分比指定一个整数。 将 OrchestrationType 参数设置为 Number 或 Percentage时，请使用此参数。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PostScript
根据需要，指定要在部署运行和设备重启 后 在每个设备上运行的 PowerShell 脚本。
此字符串值是脚本本身的文本。 如果文件中有要使用的脚本，请先将其读入变量。 例如，使用内置的 Get-Content cmdlet。
对于成功，脚本应返回 值 0 。 任何非零值都被视为脚本失败。 不能将脚本与参数一起使用。 最大脚本长度为 50,000 个字符。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PostScriptTimeoutSec
指定后脚本在超时前允许运行的时间（秒）的整数值。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PreScript
指定要在部署运行 之前 在每个设备上运行的 PowerShell 脚本。
此字符串值是脚本本身的文本。 如果文件中有要使用的脚本，请先将其读入变量。 例如，使用内置的 Get-Content cmdlet。
对于成功，脚本应返回 值 0 。 任何非零值都被视为脚本失败。 不能将脚本与参数一起使用。 最大脚本长度为 50,000 个字符。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PreScriptTimeoutSec
指定允许运行前脚本在超时之前运行的时间（秒）的整数值。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SiteCode
指定此业务流程组及其成员的站点代码。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject
备注
此 cmdlet 返回 SMS_MachineOrchestrationGroup WMI 类的对象。