Get-CMOrchestrationGroup

オーケストレーション グループ オブジェクトを取得します。

構文

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

説明

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

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

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから 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 と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

取得するオーケストレーション グループの ID を指定します。 この値は 、整数である MOGID プロパティです。 たとえば、「 16777217 」のように入力します。

型:Int32
Aliases:MOGID
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

取得するオーケストレーション グループの名前を指定します。

型:String
Aliases:OrchestrationGroupName
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject

メモ

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