Set-CMOrchestrationGroup

構文

Set-CMOrchestrationGroup
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-Description <String>]
   [-OrchestrationType <OrchestrationTypeValue>]
   [-OrchestrationValue <Int32>]
   [-OrchestrationTimeOutMin <Int32>]
   [-MaxLockTimeOutMin <Int32>]
   [-PreScript <String>]
   [-PreScriptTimeoutSec <Int32>]
   [-PostScript <String>]
   [-PostScriptTimeoutSec <Int32>]
   [-MemberResourceIds <Int32[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMOrchestrationGroup
   [-Id] <Int32>
   [-NewName <String>]
   [-Description <String>]
   [-OrchestrationType <OrchestrationTypeValue>]
   [-OrchestrationValue <Int32>]
   [-OrchestrationTimeOutMin <Int32>]
   [-MaxLockTimeOutMin <Int32>]
   [-PreScript <String>]
   [-PreScriptTimeoutSec <Int32>]
   [-PostScript <String>]
   [-PostScriptTimeoutSec <Int32>]
   [-MemberResourceIds <Int32[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMOrchestrationGroup
   [-Name] <String>
   [-NewName <String>]
   [-Description <String>]
   [-OrchestrationType <OrchestrationTypeValue>]
   [-OrchestrationValue <Int32>]
   [-OrchestrationTimeOutMin <Int32>]
   [-MaxLockTimeOutMin <Int32>]
   [-PreScript <String>]
   [-PreScriptTimeoutSec <Int32>]
   [-PostScript <String>]
   [-PostScriptTimeoutSec <Int32>]
   [-MemberResourceIds <Int32[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

オーケストレーション グループを構成するには、このコマンドレットを使用します。

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

例

例 1: 型を変更し、シーケンスを指定する

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

次のコマンドは、 devices という名前の配列を定義します。 IT サーバー オーケストレーション グループ ($og.MOGMembers) の各メンバーをループし、メンバーの ID を Get-CMDevice コマンドレットに渡します。 返されたデバイス オブジェクトが devices 配列に追加されます。

次のコマンドは、デバイス名で配列を並べ替え、デバイス リソース ID を sortedIDs 変数に返します。

次に、コマンドレット パラメーターを parameters 変数にスプラットします。 パラメーターをスプラッタする必要はありません。これにより、このような長いコマンド ラインのパラメーターを読みやすくなります。

最後のコマンドは、指定したオーケストレーション グループを、シーケンスの定義された順序で構成します。 メンバーの追加や削除ではなく、 MemberResourceIds パラメーターを使用してシーケンスを設定しています。

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

$devices = @()
foreach ( $id in $og.MOGMembers ) {
  $devices += Get-CMDevice -Id $id -Fast
}

$sortedIDs = ( $devices | Sort-Object -Property Name | Select-Object ResourceId ).ResourceId

$parameters = @{
  InputObject = $og
  Description = "Change type and sequence"
  OrchestrationType = "Sequence"
  MemberResourceIds = $sortedIDs
}

Set-CMOrchestrationGroup @parameters

この例では、既存のメンバーのプログラムによる並べ替えを行う方法を示します。 オーケストレーション グループのメンバーシップが変更されない場合は、次の一般的なプロセスが使用されます。

1. 既存のメンバー リソース ID を使用します。
2. 各リソースの詳細を取得します。
3. その情報の一覧を並べ替えます。
4. 新しく並べ替えられたリストのリソース ID を返します。

この例では 、Get-CMDevice を使用して詳細情報を取得しますが、デバイス リソース ID を入力として使用するコマンドレットに置き換えることができます。 並べ替えメカニズムを別の関数に置き換えることもできます。

例 2: ファイルからスクリプト コンテンツを取得する

この例では、組み込みの Get-Content コマンドレットを使用して、ローカル ファイルからスクリプト テキストを読み取ります。 スクリプト テキストは postScript 変数に格納されます。 2 番目のコマンドは、新しい事後スクリプトを使用してオーケストレーション グループを構成します。

$postScript - Get-Content -Path "D:\Scripts\OG\Post1.ps1"
Set-CMOrchestrationGroup -InputObject $og -PostScript $postScript

パラメーター

-Confirm

-Description

-DisableWildcardHandling

-ForceWildcardHandling

-Id

-InputObject

-MaxLockTimeOutMin

-MemberResourceIds

-Name

-NewName

-OrchestrationTimeOutMin

-OrchestrationType

-OrchestrationValue

-PostScript

-PostScriptTimeoutSec

-PreScript

-PreScriptTimeoutSec

-WhatIf

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

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

関連リンク

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