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 参数 Splatsparameters 变量中。 不需要对参数进行 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-CMDeviceGet-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 参数设置为 NumberPercentage时,请使用此参数。

类型: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 类的对象。