Set-CMOperatingSystemImageUpdateSchedule

Set-CMOperatingSystemImageUpdateSchedule

Sets a schedule for an operating system image update in System Center 2012 Configuration Manager.

構文

Parameter Set: SetScheduleById
Set-CMOperatingSystemImageUpdateSchedule -Id <String> -SoftwareUpdate <IResultObject[]> [-ContinueOnError <Boolean> ] [-CustomSchedule <DateTime> ] [-UpdateDistributionPointsWithImage <Boolean> ] [-Utc <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetScheduleByIdRunNow
Set-CMOperatingSystemImageUpdateSchedule -Id <String> -SoftwareUpdate <IResultObject[]> [-ContinueOnError <Boolean> ] [-RunNow] [-UpdateDistributionPointsWithImage <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetScheduleByInputObject
Set-CMOperatingSystemImageUpdateSchedule -InputObject <IResultObject> -SoftwareUpdate <IResultObject[]> [-ContinueOnError <Boolean> ] [-CustomSchedule <DateTime> ] [-UpdateDistributionPointsWithImage <Boolean> ] [-Utc <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetScheduleByInputObjectRunNow
Set-CMOperatingSystemImageUpdateSchedule -InputObject <IResultObject> -SoftwareUpdate <IResultObject[]> [-ContinueOnError <Boolean> ] [-RunNow] [-UpdateDistributionPointsWithImage <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetScheduleByName
Set-CMOperatingSystemImageUpdateSchedule -Name <String> -SoftwareUpdate <IResultObject[]> [-ContinueOnError <Boolean> ] [-CustomSchedule <DateTime> ] [-UpdateDistributionPointsWithImage <Boolean> ] [-Utc <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetScheduleByNameRunNow
Set-CMOperatingSystemImageUpdateSchedule -Name <String> -SoftwareUpdate <IResultObject[]> [-ContinueOnError <Boolean> ] [-RunNow] [-UpdateDistributionPointsWithImage <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-CMOperatingSystemImageUpdateSchedule cmdlet sets a schedule for updating an operating system image in Microsoft System Center 2012 Configuration Manager.

パラメーター

-ContinueOnError<Boolean>

Indicates whether the update process continues if it encounters an error.

-CustomSchedule<DateTime>

Specifies a date time value, in D.HH:MM:SS format, for a custom schedule.

-Id<String>

Specifies an identifier of an operating system image update schedule in Configuration Manager.

-InputObject<IResultObject>

Specifies an input object.

-Name<String>

Specifies the name of an operating system image update schedule in Configuration Manager.

-RunNow

Indicates that the schedule is set by ID, input object, or name, and run now.

-SoftwareUpdate<IResultObject[]>

Specifies an array of input objects.

-UpdateDistributionPointsWithImage<Boolean>

Indicates whether to update distribution points with the image.

-Utc<Boolean>

Indicates whether to use Coordinated Universal Time (UTC).

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Set an update schedule

The first command uses the Get-CMSoftwareUpdate cmdlet to get the software update associated with the identifier 308, and stores the result in the $SoftwareUpdate variable.

The second command uses the Set-CMOperatingSystemImageUpdateSchedule cmdlet to set the schedule the update to run now.

PS C:\> $SoftwareUpdate = Get-CMSoftwareUpdate -Id "308"
PS C:\> Set-CMOperatingSystemImageUpdateSchedule -SoftwareUpdate $SoftwareUpdate -Name "Microsoft Windows 8 (x86)" -RunNow -ContinueOnError $True -UpdateDistributionPointsWithImage $True

Example 2: Set a custom update schedule

This example sets a custom update schedule by using the CustomSchedule parameter to specify a date and time to run the update.

The first command uses the Get-CMSoftwareUpdate cmdlet to get the software updated associated with the identifier 308, and stores the value in the $SoftwareUpdate variable.

The second command sets the update schedule and specifies a date time to run the update. The command also specifies UTC time.

PS C:\> $SoftwareUpdate = Get-CMSoftwareUpdate -Id "308"
PS C:\> Set-CMOperatingSystemImageUpdateSchedule -SoftwareUpdate $SoftwareUpdate -Name "Microsoft Windows 8 (x86)" -CustomSchedule "2012/11/17 10:00:00" -Utc $True

関連トピック

Clear-CMOperatingSystemImageUpdateSchedule

Get-CMOperatingSystemImageUpdateSchedule