Remove-CMConfigurationItem
SYNOPSIS
Remove itens de configuração do Gestor de Configuração.
SYNTAX
SearchByIdMandatory (Padrão)
Remove-CMConfigurationItem [-Force] [-Id] <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
SearchByValueMandatory
Remove-CMConfigurationItem [-Force] [-InputObject] <IResultObject> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
PesquisaByNameMandatory
Remove-CMConfigurationItem [-Force] [-Name] <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
O cmdlet Remove-CMConfigurationItem remove itens de configuração especificados do Gestor de Configuração. Pode especificar itens por ID, nome ou pela utilização 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 deseja.
Se remover um item de configuração que tenha sido implantado numa coleção, a implementação também será removida.
Para obter mais informações sobre itens de configuração, consulte Introdução à conformidade Definições no Gestor de Configuração.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Remover um item usando um ID
PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"
Este 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"
Este 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 armazena-o na variável $CIObj.
O segundo comando remove o item armazenado na variável $CIObj.
PARAMETERS
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Força o comando a funcionar sem pedir confirmação do utilizador.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifica uma matriz de identificadores para um ou mais itens de configuração. Pode usar uma lista separada de vírgula.
Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID
Required: True
Position: 0
Default value: None
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, pode utilizar o cmdlet Get-CMConfigurationItem.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Especifica uma série de nomes de itens de configuração.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
Sistema.Objeto
NOTAS
RELATED LINKS
Introdução ao Definições de conformidade no Gestor de Configuração
Get-CMConfigurationItemXMLDefinition
Get-CMConfigurationItemHistory