Remove-CMConfigurationItem

Artykuł
08/17/2021

SYNOPSIS

Usuwa elementy konfiguracji z Menedżer konfiguracji.

SYNTAX

SearchByIdMandatory (ustawienie domyślne)

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

Polecenie cmdlet Remove-CMConfigurationItem usuwa określone elementy konfiguracji z Menedżer konfiguracji. Elementy można określić według identyfikatora, nazwy lub za pomocą polecenia cmdlet .

Elementy konfiguracji zawierają co najmniej jedno ustawienia wraz z regułami zgodności. Elementy zazwyczaj definiują jednostkę konfiguracji, którą chcesz.

Jeśli usuniesz element konfiguracji, który został wdrożony w kolekcji, wdrożenie również zostanie usunięte.

Aby uzyskać więcej informacji na temat elementów konfiguracji, zobacz Introduction to Compliance Ustawienia in Menedżer konfiguracji.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: usuwanie elementu przy użyciu identyfikatora

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

To polecenie usuwa element konfiguracji o określonym identyfikatorze.

Przykład 2: Usuwanie elementu przy użyciu nazwy

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

To polecenie usuwa element konfiguracji o nazwie ConfigItem76.

Przykład 3: Usuwanie elementu przy użyciu zmiennej

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

Pierwsze polecenie pobiera element konfiguracji z określonym identyfikatorem i zapisuje go w $CIObj zmiennej.

Drugie polecenie usuwa element przechowywany w zmiennej $CIObj zmiennej .

PARAMETERS

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

Wymusza uruchomienie polecenia bez pytania o potwierdzenie przez użytkownika.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id (Identyfikator)

Określa tablicę identyfikatorów dla jednego lub większej liczby elementów konfiguracji. Można użyć listy rozdzielonych przecinkami.

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

Określa obiekt elementu konfiguracji. Aby uzyskać obiekt elementu konfiguracji, można użyć polecenia 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

Określa tablicę nazw elementów konfiguracji.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.