Clear-CMOperatingSystemImageUpdateSchedule

Removes a schedule for updating an operating system image.

Syntax

Clear-CMOperatingSystemImageUpdateSchedule
     [-Confirm]
     [-DisableWildcardHandling]
     [-Force]
     [-ForceWildcardHandling]
     -Id <String>
     [-WhatIf]
     [<CommonParameters>]
Clear-CMOperatingSystemImageUpdateSchedule [-Confirm] [-DisableWildcardHandling] [-Force]
 [-ForceWildcardHandling] -InputObject  [-WhatIf] []
Clear-CMOperatingSystemImageUpdateSchedule [-Confirm] [-DisableWildcardHandling] [-Force]
 [-ForceWildcardHandling] -Name  [-WhatIf] []

Description

The Clear-CMOperatingSystemImageUpdateSchedule cmdlet removes a schedule for updating an operating system image from a Microsoft System Center Configuration Manager site.

Operating system images are .wim format files, which represent a compressed collection of reference files and folders that System Center Configuration Manager requires to successfully install and configure an operating system on a computer. You can use System Center Configuration Manager to define a schedule for updating these images by using Component Based Servicing (CBS), then delete unwanted schedules by using this cmdlet.

Examples

Example 1: Remove a schedule for updating an operating system image by using a name

PS C:\>Clear-CMOperatingSystemUpdateSchedule -OperatingSystemImageName "Win8UpdateSchedule"

This command removes a schedule named Win8UpdateSchedule that updates an operating system image.

Example 2: Remove a schedule for updating an operating system image by using an object

PS C:\> $Win8UpdateSchedule = Get-CMOperatingSystemUpdateSchedule -Id 1207
PS C:\> Clear-CMOperatingSystemImageUpdateSchedule -OperatingSystemImageName "Win8UpdateSchedule"

The first command gets the image update schedule by using the ID 1207. The command stores this schedule in the $UpdateSchedObject variable.

The second command removes the image update schedule by using $UpdateSchedObject.

Required Parameters

-Id
Type:String
Aliases:OperatingSystemImageId
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

Type:IResultObject
Aliases:OperatingSystemImage, ServicingSchedule
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name
Type:String
Aliases:OperatingSystemImageName
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False