Remove-CMPackage

  • Referência
Módulo:
ConfigurationManager

Remove um pacote de Configuration Manager.

Syntax

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

Description

O cmdlet Remove-CMPackage remove um pacote no Configuration Manager. Você pode excluir um pacote do site em que ele foi criado. Configuration Manager não poderá excluir um pacote de um ponto de distribuição se um usuário tiver bloqueado um arquivo de rede.

Quando você remove um pacote, Configuration Manager o remove do banco de dados. Se o pacote foi enviado para sites filho, Configuration Manager removerá as informações do pacote nesses sites filho. Se existir uma versão compactada dos arquivos de origem para o pacote, Configuration Manager excluirá o arquivo compactado do servidor do site.

Observação

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

Exemplos

Exemplo 1: remover um pacote

PS XYZ:\> Remove-CMPackage -Id "CM10000D"

Esse comando remove o pacote que tem a ID CM10000D.

Exemplo 2: remover um pacote usando uma variável de objeto

PS XYZ:\> $Pkg = Get-CMPackage -Id "CM10000D"
PS XYZ:\> Remove-CMPackage -InputObject $Pkg

O primeiro comando obtém o pacote que tem a ID CM10000D e armazena os resultados para a variável $Pkg.

O segundo comando remove o pacote armazenado na variável $Pkg.

Parâmetros

-Confirm

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

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-Id

Especifica uma matriz de IDs de pacote.

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

-InputObject

Especifica um objeto CMPackage . Para obter um objeto CMPackage , use o cmdlet Get-CMPackage .

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

-Name

Especifica uma matriz de nomes de pacote.

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

-WhatIf

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object