Get-CMOrchestrationGroup

  • リファレンス
モジュール:
ConfigurationManager

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

構文

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

説明

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

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

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 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 と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Id

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

Type:Int32
Aliases:MOGID
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

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

Type:String
Aliases:OrchestrationGroupName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

None

出力

IResultObject

メモ

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