Delen via


Remove-CMConfigurationItem

SYNOPSIS

Hiermee verwijdert u configuratie-items Configuration Manager.

SYNTAX

SearchByIdMandatory (standaard)

Remove-CMConfigurationItem [-Force] [-Id] <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SearchByValueMandatory

Remove-CMConfigurationItem [-Force] [-InputObject] <IResultObject> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByNameMandatory

Remove-CMConfigurationItem [-Force] [-Name] <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

De cmdlet Remove-CMConfigurationItem verwijdert opgegeven configuratie-items uit Configuration Manager. U kunt items opgeven op id, naam of met de cmdlet .

Configuratie-items bevatten een of meer instellingen, samen met nalevingsregels. Items definiëren meestal een configuratie-eenheid die u wilt.

Als u een configuratie-item verwijdert dat is geïmplementeerd in een verzameling, wordt de implementatie ook verwijderd.

Zie Introduction to Compliance Instellingen in Configuration Manager voor meer informatie over configuratie-items.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een item verwijderen met behulp van een id

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

Met deze opdracht wordt een configuratie-item met de opgegeven id verwijderd.

Voorbeeld 2: Een item verwijderen met een naam

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

Met deze opdracht wordt een configuratie-item met de naam ConfigItem76 verwijderd.

Voorbeeld 3: Een item verwijderen met behulp van een variabele

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

Met de eerste opdracht wordt een configuratie-item met de opgegeven id opgeslagen in de $CIObj variabele.

Met de tweede opdracht wordt het item verwijderd dat is opgeslagen in de $CIObj variabele.

PARAMETERS

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Hiermee geeft u een matrix met id's op voor een of meer configuratie-items. U kunt een door komma's gescheiden lijst gebruiken.

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

Hiermee geeft u een configuratie-itemobject. Als u een configuratie-itemobject wilt verkrijgen, kunt u de cmdlet Get-CMConfigurationItem gebruiken.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Hiermee geeft u een matrix met namen van configuratie-items.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Inleiding tot naleving Instellingen in Configuration Manager

Get-CMConfigurationItem

Get-CMConfigurationItemXMLDefinition

Get-CMConfigurationItemHistory

New-CMConfigurationItem

Set-CMConfigurationItem

Import-CMConfigurationItem

Export-CMConfigurationItem

ConvertTo-CMConfigurationItem

ConvertFrom-CMConfigurationItem