Remove-CMContentDistribution

Module:

ConfigurationManager

Remove packages from a distribution point.

Syntax

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DisableContentDependencyDetection]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      -ApplicationId <String[]>
      [-CollectionName <String[]>]
      [-DisableContentDependencyDetection]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      -ApplicationName <String[]>
      [-CollectionName <String[]>]
      [-DisableContentDependencyDetection]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      -BootImageId <String[]>
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      -BootImageName <String[]>
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      -DeploymentPackageId <String[]>
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      -DeploymentPackageName <String[]>
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -DriverPackageId <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -DriverPackageName <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -OperatingSystemImage <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -OperatingSystemImageId <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -OperatingSystemImageName <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -OperatingSystemInstallerId <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -OperatingSystemInstallerName <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -PackageId <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -PackageName <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -TaskSequenceId <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMContentDistribution
      [-Force]
      [-CollectionName <String[]>]
      [-DistributionPointGroupName <String[]>]
      [-DistributionPointName <String[]>]
      -TaskSequenceName <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use this cmdlet to remove one or more packages from a distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Remove a driver package from a distribution point

This command removes the driver package PCO00019 from the distribution point distribution-server.contoso.com.

Remove-CMContentDistribution -DriverPackageID "PCP00019" -DistributionPointName "distribution-server.contoso.com"

Parameters

-ApplicationId

Specify an array of application IDs to remove. These IDs are GUIDs as strings.

By default, Configuration Manager also removes the content for dependent applications. To disable this behavior, use the DisableContentDependencyDetection parameter.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

Specify an array of application names to remove.

By default, Configuration Manager also removes the content for dependent applications. To disable this behavior, use the DisableContentDependencyDetection parameter.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BootImageId

Specify an array of boot image IDs to remove. For example, "XYZ00015".

Type:	String[]
Aliases:	BootImageIds
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BootImageName

Specify an array of boot image names to remove.

Type:	String[]
Aliases:	BootImageNames
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Specify an array of Configuration Manager collection names. Use this collection to target the distribution points from which to remove the content.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DeploymentPackageId

Specify an array of software update deployment package IDs to remove. For example, "XYZ00016".

Type:	String[]
Aliases:	DeploymentPackageIds, SoftwareUpdatesPackageId, SoftwareUpdatesPackageIds
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentPackageName

Specify an array of software update deployment package names to remove.

Type:	String[]
Aliases:	DeploymentPackageNames, SoftwareUpdatesPackageName, SoftwareUpdatesPackageNames
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableContentDependencyDetection

Add this parameter to not automatically remove content for dependent apps.

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

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-DistributionPointGroupName

Specify an array of distribution point group names from which to remove the content.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointName

Specify an array of distribution point names from which to remove the content.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DriverPackageId

Specify an array of driver package IDs to remove. For example, "XYZ00017".

Type:	String[]
Aliases:	DriverPackageIds
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DriverPackageName

Specify an array of driver package names to remove.

Type:	String[]
Aliases:	DriverPackageNames
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Run the command without asking for confirmation.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-InputObject

Specify an object type to remove. To get these objects, use one of the following cmdlets:

• Get-CMApplication for an application
• Get-CMPackage for a legacy package
• Get-CMBootImage for a boot image
• Get-CMDeploymentPackage for a software update deployment package
• Get-CMSoftwareUpdateGroup for the content in a software update group
• Get-CMDriverPackage for a driver package
• Get-CMOperatingSystemImage for an OS image
• Get-CMOperatingSystemInstaller for an OS upgrade package
• Get-CMTaskSequence for the content referenced by a task sequence

Type:	IResultObject
Aliases:	Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-OperatingSystemImage

Specify an OS image object to remove. To get this object, use the Get-CMOperatingSystemImage cmdlet.

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OperatingSystemImageId

Specify an array of OS image IDs to remove. For example, "XYZ00018".

Type:	String[]
Aliases:	OperatingSystemImageIds
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OperatingSystemImageName

Specify an array of OS image names to remove.

Type:	String[]
Aliases:	OperatingSystemImageNames
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OperatingSystemInstallerId

Specify an array of OS upgrade package IDs to remove. For example, "XYZ00019".

Type:	String[]
Aliases:	OperatingSystemInstallerIds
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OperatingSystemInstallerName

Specify an array of OS upgrade package names to remove.

Type:	String[]
Aliases:	OperatingSystemImageInstallerNames
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageId

Specify an array of legacy package IDs to remove. For example, "XYZ00020".

Type:	String[]
Aliases:	PackageIds
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageName

Specify an array of legacy package names to remove.

Type:	String[]
Aliases:	PackageNames
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TaskSequenceId

Specify an array of task sequence IDs to remove referenced content. For example, "XYZ00021".

Type:	String[]
Aliases:	TaskSequenceIds
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TaskSequenceName

Specify an array of task sequence names to remove referenced content.

Type:	String[]
Aliases:	TaskSequenceNames
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object

Related Links

• Get-CMApplication
• Get-CMBootImage
• Get-CMDeploymentPackage
• Get-CMDriverPackage
• Get-CMOperatingSystemImage
• Get-CMOperatingSystemInstaller
• Get-CMPackage
• Get-CMTaskSequence
• Invoke-CMContentValidation
• Start-CMContentDistribution
• Update-CMDistributionPoint