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