Remove-CMBootImage

Removes an operating system boot image.

Syntax

Remove-CMBootImage
      [-Confirm]
      [-DisableWildcardHandling]
      [-Force]
      [-ForceWildcardHandling]
      -Id <String>
      [-WhatIf]
      [<CommonParameters>]
Remove-CMBootImage [-Confirm] [-DisableWildcardHandling] [-Force] [-ForceWildcardHandling]
 -InputObject  [-WhatIf] []
Remove-CMBootImage [-Confirm] [-DisableWildcardHandling] [-Force] [-ForceWildcardHandling] -Name 
 [-WhatIf] []

Description

The Remove-CMBootImage cmdlet removes a Windows Preinstallation Environment (Windows PE) operating system boot image from Microsoft System Center Configuration Manager.

You must run Remove-CMBootImage on the computer that is running the Systems Management Server (SMS) provider. The computer account of the computer that is running the SMS provider must have Read and Write access to the package source of the boot image. For more information about the SMS provider, see Planning for the SMS Provider in Configuration Manager on TechNet.

Examples

Example 1: Remove a boot image object that is identified by using its ID

PS C:\> Remove-CMBootImage -Id "CM100004" -Confirm

This command removes a boot image object that is identified by using its ID. You must confirm the action before the command performs it.

Example 2: Remove a boot image object that is identified by using its name

PS C:\> Remove-CMBootImage -Name "Boot image (86)" -Confirm

This command removes a boot image object that is identified by using its name. You must confirm the action before the command performs it.

Required Parameters

-Id

Specifies an array of boot images identifiers. You can get a boot image object by using the Get-CMBootImage cmdlet.

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

Specifies a boot image object.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

Specifies a name of a boot image.

Type:String
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