Share via

Remove-CMConfigurationItem

  • Referência
Módulo:
ConfigurationManager

Remove itens de configuração de Configuration Manager.

Syntax

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

Description

O cmdlet Remove-CMConfigurationItem remove itens de configuração especificados de Configuration Manager. Você pode especificar itens por ID, nome ou pelo uso do cmdlet.

Os itens de configuração contêm uma ou mais configurações, juntamente com as regras de conformidade. Os itens geralmente definem uma unidade de configuração que você deseja.

Se você remover um item de configuração que foi implantado em uma coleção, a implantação também será removida.

Para obter mais informações sobre itens de configuração, consulte Introdução às Configurações de Conformidade no Configuration Manager.

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 item usando uma ID

PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"

Esse comando remove um item de configuração com o identificador especificado.

Exemplo 2: remover um item usando um nome

PS XYZ:\> Remove-CMConfigurationItem -Name "ConfigItem76"

Esse comando remove um item de configuração chamado ConfigItem76.

Exemplo 3: remover um item usando uma variável

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

O primeiro comando obtém um item de configuração com o identificador especificado e o armazena na variável $CIObj.

O segundo comando remove o item armazenado na variável $CIObj.

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 identificadores para um ou mais itens de configuração. Você pode usar uma lista separada por vírgulas.

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica um objeto de item de configuração. Para obter um objeto de item de configuração, você pode usar o cmdlet Get-CMConfigurationItem .

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

-Name

Especifica uma matriz de nomes de itens de configuração.

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

-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