New-CMOperatingSystemImageUpdateSchedule

モジュール:

ConfigurationManager

オペレーティング システム イメージの更新スケジュールを作成します。

構文

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   -InputObject <IResultObject>
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -Id <String>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -InputObject <IResultObject>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -Name <String>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-CMOperatingSystemImageUpdateSchedule コマンドレットは、オペレーティング システム イメージの更新スケジュールを作成します。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: オペレーティング システム イメージの更新スケジュールを作成する

PS ABC:\> $Win10Image = Get-CMOperatingSystemImage -Name "Windows 10 Enterprise"
PS ABC:\> $Win10SU = Get-CMSoftwareUpdate -UpdateGroupName "Win10SUgroup01"
PS ABC:\> New-CMOperatingSystemImageUpdateSchedule -Name $Win10Image.Name -SoftwareUpdate $Win10SU -RunNow -ContinueOnError $True

最初のコマンドは、Windows 10 Enterprise という名前のオペレーティング システム イメージ オブジェクトを取得し、オブジェクトを $Win 10Image 変数に格納します。

2 番目のコマンドは、Win10SUgroup01 という名前の更新グループのソフトウェア更新オブジェクトを取得し、そのオブジェクトを $Win 10SU 変数に格納します。

最後のコマンドでは、オペレーティング システム イメージの更新スケジュールを作成し、Windows 10 Enterprise という名前のオペレーティング システム イメージを、$Win 10SU に格納されている更新プログラムで更新します。 これで更新プログラムが実行され、エラーが発生した場合でも更新プログラムが適用されます。

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ContinueOnError

エラーが発生した場合でも、ソフトウェア更新プログラムをイメージに適用するかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CustomSchedule

ソフトウェア更新プログラムがオペレーティング システム イメージに適用される日時を指定します。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

オペレーティング システム イメージの ID を指定します。

型:	String
Aliases:	PackageId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

オペレーティング システム イメージ オブジェクトを指定します。 オペレーティング システム イメージ オブジェクトを取得するには、 Get-CMOperatingSystemImage コマンドレットを 使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

オペレーティング システム イメージの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveSupersededUpdates

{{ Fill RemoveSupersededUpdates Description }}

型:	Boolean
Aliases:	CleanUp
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RunNow

更新プログラムが今すぐ実行されることを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SoftwareUpdate

ソフトウェア更新オブジェクトの配列を指定します。 ソフトウェア更新オブジェクトを取得するには、 Get-CMSoftwareUpdate コマンドレットを使用します。

型:	IResultObject[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UpdateDistributionPoint

ソフトウェア更新プログラムの適用後に配布ポイントのオペレーティング システム イメージが更新されるかどうかを示します。

型:	Boolean
Aliases:	UpdateDistributionPointsWithImage, UpdateDistributionPoints
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Utc

UTC 時刻を使用するかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

関連リンク

• Get-CMOperatingSystemImageUpdateSchedule
• Clear-CMOperatingSystemImageUpdateSchedule