Remove-CMConfigurationItem
SYNOPSIS
Tar bort konfigurationsobjekt från Konfigurationshanteraren.
SYNTAX
SearchByIdMandatory (standard)
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
Cmdleten Remove-CMConfigurationItem tar bort angivna konfigurationsobjekt från Konfigurationshanteraren. Du kan ange objekt efter ID, namn eller med hjälp av cmdleten .
Konfigurationsobjekt innehåller en eller flera inställningar, tillsammans med efterlevnadsregler. Objekt definierar vanligtvis en konfigurationsenhet som du vill.
Om du tar bort ett konfigurationsobjekt som har distribuerats till en samling tas även distributionen bort.
Mer information om konfigurationsobjekt finns i Introduktion till efterlevnad Inställningar i Konfigurationshanteraren.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Ta bort ett objekt med hjälp av ett ID
PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"
Det här kommandot tar bort ett konfigurationsobjekt med den angivna identifieraren.
Exempel 2: Ta bort ett objekt med ett namn
PS XYZ:\> Remove-CMConfigurationItem -Name "ConfigItem76"
Det här kommandot tar bort ett konfigurationsobjekt med namnet ConfigItem76.
Exempel 3: Ta bort ett objekt med hjälp av en variabel
PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj
Det första kommandot hämtar ett konfigurationsobjekt med den angivna identifieraren och lagrar det i $CIObj variabeln.
Det andra kommandot tar bort objektet som lagras i $CIObj variabeln.
PARAMETERS
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Tvingar kommandot att köras utan att fråga efter användarens bekräftelse.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Anger en matris med identifierare för ett eller flera konfigurationsobjekt. Du kan använda en kommaavgränsad lista.
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
Anger ett konfigurationsobjekt. Om du vill hämta ett konfigurationsobjekt kan du använda cmdleten 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
Anger en matris med namn på konfigurationsobjekt.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
ANTECKNINGAR
RELATED LINKS
Introduktion till efterlevnad Inställningar i Konfigurationshanteraren
Get-CMConfigurationItemXMLDefinition