Get-CMOrchestrationGroup

構文

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

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

説明

このコマンドレットを使用して、名前または ID でオーケストレーション グループ オブジェクトを取得します。 このオブジェクトを使用して、オーケストレーション グループを開始、削除、または構成できます。 これらの他のアクションでは、次のコマンドレットを使用します。

• Invoke-CMOrchestrationGroup
• Remove-CMOrchestrationGroup
• Set-CMOrchestrationGroup

オーケストレーション グループを使用して、デバイスへのソフトウェア更新プログラムの展開をより適切に制御します。 特定のワークロードの更新プログラムを慎重に管理したり、その間の動作を自動化したりする必要がある場合があります。 詳細については、「 Configuration Manager のオーケストレーション グループについて」を参照してください。

例

例 1: オーケストレーション グループのメンバーに関する詳細を表示する

この例では、最初に Get-CMOrchestrationGroup コマンドレットを使用して 、IT サーバーという名前のオーケストレーション グループのオブジェクトを取得します。

次に、オーケストレーション グループの各メンバーをループ処理します。これは、そのリソース ID によって格納されます。 次に、 Get-CMDevice コマンドレットを使用して、デバイス名と OS ビルド プロパティを表示します。

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

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

例 2: 承認されていないスクリプトを使用してオーケストレーション グループを取得する

次の例では、サイトからすべてのオーケストレーション グループを取得します。 組み込みの Where-Object コマンドレットを使用して、 0の値を持ついずれかのスクリプト承認状態プロパティを持つ結果をフィルター処理します。 パイプライン演算子を再度使用して、組み込みの Select-Object コマンドレットを使用して返されるプロパティを減らし、オーケストレーション グループの名前のみを表示します。

この例を使用すると、承認されていない事前スクリプトまたは事後スクリプトを持つすべてのオーケストレーション グループを表示できます。

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

パラメーター

-DisableWildcardHandling

-ForceWildcardHandling

-Id

-Name

入力

None

出力

IResultObject

メモ

このコマンドレットは、 SMS_MachineOrchestrationGroup WMI クラスの オブジェクトを返します。

関連リンク

• Invoke-CMOrchestrationGroup
• New-CMOrchestrationGroup
• Remove-CMOrchestrationGroup
• Set-CMOrchestrationGroup
• Configuration Manager のオーケストレーション グループについて