共用方式為

Get-CMOrchestrationGroup

  • 參考
模組:
ConfigurationManager

取得協調流程群組物件。

語法

Get-CMOrchestrationGroup
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMOrchestrationGroup
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

使用此 Cmdlet 依名稱或標識碼取得協調流程群組物件。 您可以使用此物件來啟動、移除或設定協調流程群組。 針對這些其他動作，請使用下列 Cmdlet：

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

注意事項

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

範例

範例 1：檢視協調流程群組成員的詳細數據

此範例會先使用 Get-CMOrchestrationGroup Cmdlet 來取得名為 IT 伺服器之協調流程群組的物件。

然後，它會迴圈查看協調流程群組的每個成員，而協調流程群組是由其資源標識符所儲存。 然後，它會使用 Get-CMDevice Cmdlet 來顯示裝置名稱和 OS 組建屬性。

$og = Get-CMOrchestrationGroup -Name "IT servers"

foreach ( $member in $og.MOGMembers ) {
  Get-CMDevice -Id $member -Fast | Select-Object Name, Build
}

範例 2：使用未經核准的腳本取得協調流程群組

下列範例會從網站取得所有協調流程群組。 它會使用內建的 Where-Object Cmdlet 來篩選具有其中一個腳本核准狀態屬性且值為 0的結果。 它再次使用管線運算符，以內建 的 Select-Object Cmdlet 減少傳回的屬性，只顯示協調流程群組的名稱。

您可以使用此範例來顯示具有未核准前置或後置腳本的所有協調流程群組。

Get-CMOrchestrationGroup | Where-Object ( $_.PostScriptApprovalState -eq $false -or $_.PreScriptApprovalState -eq $false ) | Select-Object Name

參數

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定要取得之協調流程群組的標識碼。 這個值是 MOGID 屬性，也就是整數。 例如，16777217。

類型:Int32
別名:MOGID
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Name

指定要取得之協調流程群組的名稱。

類型:String
別名:OrchestrationGroupName
Position:0
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

IResultObject

備註

此 Cmdlet 會傳回SMS_MachineOrchestrationGroup WMI 類別 的 物件。