New-CMSoftwareUpdateManualPhasedDeployment
ソフトウェア更新プログラムの段階的な展開を作成します。
構文
New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateGroup] <IResultObject>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateGroupId] <String>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateGroupName] <String>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateIds] <String[]>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateNames] <String[]>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdates] <IResultObject[]>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットを使用して、ソフトウェア更新プログラムの段階的な展開を作成します。 このコマンドレットを使用する前に、 New-CMSoftwareUpdatePhase コマンドレットを使用して、新しいカスタマイズされたデプロイ フェーズを追加します。
詳細については、「 Configuration Manager を使用して段階的なデプロイを作成する」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ソフトウェア更新プログラムの展開を名前で作成する
この例では、2 つのソフトウェア更新プログラムに 対して myPhaseDeployment という名前の 2 フェーズ展開を作成します。
$phase1 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotificationOption DisplaySoftwareCenterOnly
$phase2 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateNames ("myUpdateA", "myUpdateB") -Name "myPhaseDeployment" -AddPhases ($phase1, $phase2)例 2: ソフトウェア更新プログラム グループの展開を名前で作成する
この例では、ソフトウェア更新グループ myGroup の myPhaseDeploymentForGroup という名前の 2 フェーズ展開を作成 します。
$phase3 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotificationOption DisplaySoftwareCenterOnly
$phase4 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateGroupName "myGroup" -Name "myPhaseDeploymentForGroup" -AddPhases ($phase3, $phase4)パラメーター
-AddPhases
フェーズの配列を指定します。 New-CMSoftwareUpdatePhase を使用してフェーズを作成します。
| 型: | Phase[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
ソフトウェア更新プログラムの段階的な展開の説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
ソフトウェア更新プログラムの段階的展開の名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateGroup
ソフトウェア更新グループのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSoftwareUpdateGroup コマンドレットを使用します。
| 型: | IResultObject |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateGroupId
ソフトウェア更新プログラム グループを ID で指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateGroupName
ソフトウェア更新プログラム グループを名前で指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateIds
ソフトウェア更新プログラム ID の配列を指定します。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdateNames
ソフトウェア更新プログラム名の配列を指定します。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareUpdates
ソフトウェア更新オブジェクトの配列を指定します。 このオブジェクトを取得するには、 Get-CMSoftwareUpdate コマンドレットを使用します。
| 型: | IResultObject[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
出力
IResultObject
メモ
return オブジェクトは、 SMS_PhasedDeployment サーバー WMI クラスです。