New-CMOrchestrationGroup
新しいオーケストレーション グループを作成します。
構文
New-CMOrchestrationGroup
[-Name] <String>
-SiteCode <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>] 説明
このコマンドレットを使用して、新しいオーケストレーション グループを作成します。
オーケストレーション グループを使用して、デバイスへのソフトウェア更新プログラムの展開をより適切に制御します。 特定のワークロードの更新プログラムを慎重に管理するか、間の動作を自動化する必要がある場合があります。 詳細については、「Create and use オーケストレーション グループ in Configuration Manager」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 1
次の使用 例は、 まずコマンドレット パラメーターを parameters 変数に スプラット します。 パラメーターをスプラットする必要はありません。このような長いコマンド ラインのパラメーターを読みやすくします。
デバイス変数内のオーケストレーション グループに追加するデバイスのオブジェクトが含まれています。
このコマンドは、テストの目的で既定の設定と単純なスクリプトを含むオーケストレーション グループを作成します。
$parameters = @{
Name = "IT servers"
SiteCode = "XYZ"
Description = "An OG for IT servers with default settings"
OrchestrationType = "Number"
OrchestrationValue = 1
OrchestrationTimeOutMin = 720
MaxLockTimeOutMin = 60
PreScript = "Write-Host 'Pre-install script'"
PreScriptTimeoutSec = 120
PostScript = "Write-Host 'POST-install script'"
PostScriptTimeoutSec = 120
MemberResourceIds = $device1.ResourceID, $device2.ResourceID
}
New-CMOrchestrationGroup @parametersパラメーター
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
オーケストレーション グループを識別するためのオプションの説明を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
オーケストレーション グループ メンバーのタイムアウトの整数値を分で指定します。 この値は、グループ内の 1 つのデバイスが更新プログラムをインストールする時間制限です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このオーケストレーション グループのメンバーとして追加するデバイスのリソース ID の配列を指定します。 リソース ID は、たとえば、整数です 16777220 。 デバイスまたはリソース オブジェクトの ResourceId プロパティです。 デバイス オブジェクトを取得するには 、Get-CMDevice コマンドレットまたは Get-CMResource コマンドレットを 使用します。
OrchestrationType パラメーターを に設定する 場合 Sequence は、このパラメーターを使用して順序を決定します。
| Type: | Int32[] |
| Aliases: | MogMembers |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
オーケストレーション グループの名前を指定します。
| Type: | String |
| Aliases: | OrchestrationGroupName |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
展開の実行後に各デバイスで実行する__ PowerShell スクリプトを指定し、必要に応じてデバイスを再起動します。
この文字列値は、スクリプト自体のテキストです。 使用するファイルにスクリプトがある場合は、まず変数に読み込む必要があります。 たとえば、組み込みの Get-Content コマンドレットを使用 します。
スクリプトは成功の値を 0 返す必要があります。 ゼロ以外の値は、スクリプトエラーと見なされます。 パラメーターを使用してスクリプトを使用することはできません。 スクリプトの最大長は 50,000 文字です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ポスト スクリプトがタイム アウトする前に実行する許可された時間の整数値を秒で指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
展開を実行する前に、各デバイスで実行する PowerShell スクリプト を指定します。
この文字列値は、スクリプト自体のテキストです。 使用するファイルにスクリプトがある場合は、まず変数に読み込む必要があります。 たとえば、組み込みの Get-Content コマンドレットを使用 します。
スクリプトは成功の値を 0 返す必要があります。 ゼロ以外の値は、スクリプトエラーと見なされます。 パラメーターを使用してスクリプトを使用することはできません。 スクリプトの最大長は 50,000 文字です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
事前スクリプトを実行してからタイム アウトする前に、許可された時間の整数値を秒で指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このオーケストレーション グループとそのメンバーのサイト コードを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
オーケストレーション グループのタイムアウトの整数値を分で指定します。 この値は、すべてのグループ メンバーが更新プログラムをインストールする時間制限です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
オーケストレーション グループの種類に対して、次のいずれかの値を指定します。
Number: 複数のデバイスを同時に更新できます。 オーケストレーション グループの全体的なサイズに関して、常に特定の数のデバイスに制限するには、この設定を使用します。 デバイスの数を指定するには、 オーケストレーション値パラメーターを使用 します。Percentage: デバイスの割合を同時に更新できます。 この設定は、オーケストレーション グループのサイズの将来の柔軟性を実現するために使用します。 割合を指定するには、 オーケストレーション値パラメーターを使用 します。Sequence: デバイスがソフトウェア更新プログラムの展開を実行する順序を明示的に定義します。 順序は 、MemberResourceIds パラメーター内のデバイス リソース ID の並べ替えによって決まります。
| Type: | OrchestrationTypeValue |
| Accepted values: | Number, Percentage, Sequence |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
同時に更新するデバイスの数または割合の整数を指定します。 このパラメーターは、オーケストレーションの種類パラメーターを に設定する 場合または Number に設定する場合に使用します Percentage 。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
出力
IResultObject
メモ
このコマンドレットは、WMI クラスのオブジェクトを SMS_MachineOrchestrationGroup します。