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:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

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

-Id

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

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

-Name

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

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

入力

None

出力

IResultObject

メモ

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