Remove-CMContentDistribution
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
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for