Remove-CMContentDistribution

Módulo:

ConfigurationManager

Remover pacotes de um ponto de distribuição.

Sintaxe

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

Utilize este cmdlet para remover um ou mais pacotes de um ponto de distribuição.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Remover um pacote de controladores de um ponto de distribuição

Este comando remove o pacote de controlador PCO00019 do ponto de distribuição distribution-server.contoso.com.

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

Parâmetros

-ApplicationId

Especifique uma matriz de IDs de aplicação a remover. Estes IDs são GUIDs como cadeias de carateres.

Por predefinição, o Configuration Manager também remove o conteúdo das aplicações dependentes. Para desativar este comportamento, utilize o parâmetro DisableContentDependencyDetection .

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ApplicationName

Especifique uma matriz de nomes de aplicações a remover.

Por predefinição, o Configuration Manager também remove o conteúdo das aplicações dependentes. Para desativar este comportamento, utilize o parâmetro DisableContentDependencyDetection .

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BootImageId

Especifique uma matriz de IDs de imagem de arranque a remover. Por exemplo, "XYZ00015".

Tipo:	String[]
Aliases:	BootImageIds
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BootImageName

Especifique uma matriz de nomes de imagens de arranque a remover.

Tipo:	String[]
Aliases:	BootImageNames
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CollectionName

Especifique uma matriz de nomes de coleções do Configuration Manager. Utilize esta coleção para direcionar os pontos de distribuição dos quais pretende remover o conteúdo.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DeploymentPackageId

Especifique uma matriz de IDs do pacote de implementação de atualização de software a remover. Por exemplo, "XYZ00016".

Tipo:	String[]
Aliases:	DeploymentPackageIds, SoftwareUpdatesPackageId, SoftwareUpdatesPackageIds
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DeploymentPackageName

Especifique uma matriz de nomes de pacotes de implementação de atualização de software a remover.

Tipo:	String[]
Aliases:	DeploymentPackageNames, SoftwareUpdatesPackageName, SoftwareUpdatesPackageNames
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableContentDependencyDetection

Adicione este parâmetro para não remover automaticamente o conteúdo das aplicações dependentes.

Tipo:	SwitchParameter
Aliases:	DisableDetectAssociatedContentDependencies
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DistributionPointGroupName

Especifique uma matriz de nomes de grupos de pontos de distribuição a partir dos quais pretende remover o conteúdo.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DistributionPointName

Especifique uma matriz de nomes de pontos de distribuição dos quais pretende remover o conteúdo.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DriverPackageId

Especifique uma matriz de IDs de pacote de controlador a remover. Por exemplo, "XYZ00017".

Tipo:	String[]
Aliases:	DriverPackageIds
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DriverPackageName

Especifique uma matriz de nomes de pacotes de controladores a remover.

Tipo:	String[]
Aliases:	DriverPackageNames
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Force

Execute o comando sem pedir confirmação.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Especifique um tipo de objeto a remover. Para obter estes objetos, utilize um dos seguintes cmdlets:

• Get-CMApplication para uma aplicação
• Get-CMPackage para um pacote legado
• Get-CMBootImage para uma imagem de arranque
• Get-CMDeploymentPackage para um pacote de implementação de atualização de software
• Get-CMSoftwareUpdateGroup para o conteúdo num grupo de atualização de software
• Get-CMDriverPackage para um pacote de controlador
• Get-CMOperatingSystemImage para uma imagem do SO
• Get-CMOperatingSystemInstaller para um pacote de atualização do SO
• Get-CMTaskSequence para o conteúdo referenciado por uma sequência de tarefas

Tipo:	IResultObject
Aliases:	Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-OperatingSystemImage

Especifique um objeto de imagem do SO a remover. Para obter este objeto, utilize o cmdlet Get-CMOperatingSystemImage .

Tipo:	IResultObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-OperatingSystemImageId

Especifique uma matriz de IDs de imagem do SO a remover. Por exemplo, "XYZ00018".

Tipo:	String[]
Aliases:	OperatingSystemImageIds
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-OperatingSystemImageName

Especifique uma matriz de nomes de imagens do SO a remover.

Tipo:	String[]
Aliases:	OperatingSystemImageNames
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-OperatingSystemInstallerId

Especifique uma matriz de IDs do pacote de atualização do SO a remover. Por exemplo, "XYZ00019".

Tipo:	String[]
Aliases:	OperatingSystemInstallerIds
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-OperatingSystemInstallerName

Especifique uma matriz de nomes de pacotes de atualização do SO a remover.

Tipo:	String[]
Aliases:	OperatingSystemImageInstallerNames
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PackageId

Especifique uma matriz de IDs de pacotes legados a remover. Por exemplo, "XYZ00020".

Tipo:	String[]
Aliases:	PackageIds
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PackageName

Especifique uma matriz de nomes de pacotes legados a remover.

Tipo:	String[]
Aliases:	PackageNames
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TaskSequenceId

Especifique uma matriz de IDs de sequência de tarefas para remover o conteúdo referenciado. Por exemplo, "XYZ00021".

Tipo:	String[]
Aliases:	TaskSequenceIds
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TaskSequenceName

Especifique uma matriz de nomes de sequência de tarefas para remover conteúdo referenciado.

Tipo:	String[]
Aliases:	TaskSequenceNames
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Links Relacionados

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