オーケストレーション グループを構成します。
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMOrchestrationGroup":{"href":"set-cmorchestrationgroup","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMOrchestrationGroup","schemaType":"PowershellCmdlet","summary":"オーケストレーション グループを構成します。
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}},"description":"オーケストレーション グループを構成するには、このコマンドレットを使用します。
\nオーケストレーション グループを使用して、デバイスへのソフトウェア更新プログラムの展開をより適切に制御します。 特定のワークロードの更新プログラムを慎重に管理したり、その間の動作を自動化したりする必要がある場合があります。 詳細については、「 Configuration Manager でオーケストレーション グループを作成して使用する」を参照してください。
\n注:
\n\n PS XYZ:\\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
この例では、既存のメンバーのプログラムによる並べ替えを行う方法を示します。 オーケストレーション グループのメンバーシップが変更されない場合は、次の一般的なプロセスが使用されます。
\nこの例では 、Get-CMDevice を使用して詳細情報を取得しますが、デバイス リソース ID を入力として使用するコマンドレットに置き換えることができます。 並べ替えメカニズムを別の関数に置き換えることもできます。
\n","summary":"この例では、最初に Get-CMOrchestrationGroup コマンドレットを使用して 、IT サーバーという名前のオーケストレーション グループのオブジェクトを取得します。 このオブジェクトは og 変数に格納されます。
\n次のコマンドは、 devices という名前の配列を定義します。 \n IT サーバー オーケストレーション グループ ($og.MOGMembers) の各メンバーをループし、メンバーの ID を Get-CMDevice コマンドレットに渡します。 返されたデバイス オブジェクトが devices 配列に追加されます。
次のコマンドは、デバイス名で配列を並べ替え、デバイス リソース ID を sortedIDs 変数に返します。
\n次に、コマンドレット パラメーターを parameters 変数にスプラットします。 パラメーターをスプラッタする必要はありません。これにより、このような長いコマンド ラインのパラメーターを読みやすくなります。
\n最後のコマンドは、指定したオーケストレーション グループを、シーケンスの定義された順序で構成します。 メンバーの追加や削除ではなく、 MemberResourceIds パラメーターを使用してシーケンスを設定しています。
\n","title":"例 1: 型を変更し、シーケンスを指定する"},{"code":"$postScript - Get-Content -Path \"D:\\Scripts\\OG\\Post1.ps1\"\nSet-CMOrchestrationGroup -InputObject $og -PostScript $postScript","description":"","summary":"この例では、組み込みの Get-Content コマンドレットを使用して、ローカル ファイルからスクリプト テキストを読み取ります。 スクリプト テキストは postScript 変数に格納されます。 2 番目のコマンドは、新しい事後スクリプトを使用してオーケストレーション グループを構成します。
\n","title":"例 2: ファイルからスクリプト コンテンツを取得する"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"get-cmorchestrationgroup","text":"Get-CMOrchestrationGroup"},{"href":"invoke-cmorchestrationgroup","text":"Invoke-CMOrchestrationGroup"},{"href":"new-cmorchestrationgroup","text":"New-CMOrchestrationGroup"},{"href":"remove-cmorchestrationgroup","text":"Remove-CMOrchestrationGroup"},{"href":"/mem/configmgr/sum/deploy-use/orchestration-groups","text":"Configuration Manager のオーケストレーション グループについて"}],"module":"ConfigurationManager","name":"Set-CMOrchestrationGroup","notes":"このコマンドレットは、 SMS_MachineOrchestrationGroup WMI クラスの オブジェクトを返します。
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"コマンドレットを実行する前に確認メッセージを表示します。
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"オーケストレーション グループを識別するために、省略可能な説明を指定します。
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 \n ForceWildcardHandling と組み合わせることはできません。
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 \n DisableWildcardHandling と組み合わせることはできません。
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"MOGID","defaultValue":"None","description":"構成するオーケストレーション グループの ID を指定します。 この値は 、整数である MOGID プロパティです。 たとえば、「 16777217 」のように入力します。
構成するオーケストレーション グループのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMOrchestrationGroup コマンドレットを使用します。
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"0","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"オーケストレーション グループ メンバーのタイムアウトの整数値を分単位で指定します。 この値は、更新プログラムをインストールするグループ内の 1 つのデバイスの時間制限です。
\n","name":"MaxLockTimeOutMin","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"MogMembers","defaultValue":"None","description":"このオーケストレーション グループのメンバーとして追加するデバイスのリソース ID の配列を指定します。 リソース ID は整数です (たとえば、 16777220)。 これは、デバイスまたはリソース オブジェクトの ResourceId プロパティです。 デバイス オブジェクトを取得するには、 Get-CMDevice コマンドレットまたは Get-CMResource コマンドレットを使用します。
\n OrchestrationType パラメーターを Sequence に設定する場合は、このパラメーターを使用して順序を決定します。
Int32[]
\n"},{"aliases":"OrchestrationGroupName","defaultValue":"None","description":"構成するオーケストレーション グループの名前を指定します。
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"0","type":"String\n"},{"aliases":"","defaultValue":"None","description":"このオーケストレーション グループの新しい名前を指定します。 オーケストレーション グループの名前を変更するには、このパラメーターを使用します。
\n","name":"NewName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"オーケストレーション グループのタイムアウトの整数値を分単位で指定します。 この値は、すべてのグループ メンバーが更新プログラムをインストールするための時間制限です。
\n","name":"OrchestrationTimeOutMin","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"オーケストレーション グループの種類に対して、次のいずれかの値を指定します。
\n\n Number: 多数のデバイスが同時に更新されるようにします。 オーケストレーション グループの全体的なサイズに関係なく、常に特定の数のデバイスに制限するには、この設定を使用します。 デバイスの数を指定するには、 OrchestrationValue パラメーターを使用します。
\n Percentage: デバイスの割合が同時に更新されるようにします。 この設定を使用して、オーケストレーション グループのサイズの将来の柔軟性を確保します。 割合を指定するには、 OrchestrationValue パラメーターを使用します。
\n Sequence: デバイスがソフトウェア更新プログラムの展開を実行する順序を明示的に定義します。 順序は、 MemberResourceIds パラメーター内のデバイス リソース ID の並べ替えによって決まります。
同時に更新するデバイスの数または割合の整数を指定します。 \n OrchestrationType パラメーターを Number または Percentage に設定する場合は、このパラメーターを使用します。
展開の実行 後 に各デバイスで実行する PowerShell スクリプトを指定し、必要に応じてデバイスを再起動します。
\nこの文字列値は、スクリプト自体のテキストです。 使用するファイルにスクリプトがある場合は、最初に変数に読み込みます。 たとえば、組み込みの Get-Content コマンドレットを 使用します。
\nスクリプトは、成功のために 0 の値を返す必要があります。 0 以外の値は、スクリプトエラーと見なされます。 パラメーターでスクリプトを使用することはできません。 スクリプトの最大長は 50,000 文字です。
ポストスクリプトがタイムアウトする前に実行できる時間の整数値を秒単位で指定します。
\n","name":"PostScriptTimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"デプロイを実行する 前 に、各デバイスで実行する PowerShell スクリプトを指定します。
\nこの文字列値は、スクリプト自体のテキストです。 使用するファイルにスクリプトがある場合は、最初に変数に読み込みます。 たとえば、組み込みの Get-Content コマンドレットを 使用します。
\nスクリプトは、成功のために 0 の値を返す必要があります。 0 以外の値は、スクリプトエラーと見なされます。 パラメーターでスクリプトを使用することはできません。 スクリプトの最大長は 50,000 文字です。
事前スクリプトがタイムアウトする前に実行できる時間の整数値を秒単位で指定します。
\n","name":"PreScriptTimeoutSec","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"wi","defaultValue":"None","description":"コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"オーケストレーション グループを構成します。
\n","syntaxes":["Set-CMOrchestrationGroup [-InputObject]オーケストレーション グループを構成します。
\n","uid":"ConfigurationManager.Set-CMOrchestrationGroup"}],"canonical_url":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/set-cmorchestrationgroup?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/set-cmorchestrationgroup?view=sccm-ps"},"pageMetadata":"オーケストレーション グループを構成するには、このコマンドレットを使用します。\nオーケストレーション グループを使用して、デバイスへのソフトウェア更新プログラムの展開をより適切に制御します。 特定のワークロードの更新プログラムを慎重に管理したり、その間の動作を自動化したりする必要がある場合があります。 詳細については、「 Configuration Manager でオーケストレーション グループを作成して使用する」を参照してください。
\n注:
\n\n PS XYZ:\\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。