共用方式為

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>]

Description

使用此 Cmdlet 建立新的協調流程群組。

使用協調流程群組，以更有效地控制將軟體更新部署至裝置。 您可能需要仔細管理特定工作負載的更新，或將兩者之間的行為自動化。 如需詳細資訊，請 參閱在 Configuration Manager 中建立和使用協調流程群組。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1

此範 例會先 將 Cmdlet 參數展開至 parameters 變數。 不一定需要套用參數，只要讓您更輕鬆地讀取這麼長命令行的參數即可。

它假設您有要新增至裝置變數中協調流程群組的 裝置 物件。

命令會建立具有預設設定和簡單腳本的協調流程群組，以供測試之用。

$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

指定要新增為此協調流程群組成員之裝置的資源標識子陣列。 資源識別碼是整數，例如 。 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 參數中的裝置資源識別碼排序。

類型: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 類別 的 物件。