Remove-CMConfigurationItem
SYNOPSIS
Odebere položky konfigurace z Správce konfigurace.
SYNTAX
SearchByIdMandatory (výchozí)
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
Rutina Remove-CMConfigurationItem odebere zadané položky konfigurace z Správce konfigurace. Položky můžete zadat podle ID, názvu nebo pomocí rutiny .
Položky konfigurace obsahují jedno nebo více nastavení spolu s pravidly dodržování předpisů. Položky obvykle definují jednotku konfigurace, kterou chcete.
Pokud odeberete položku konfigurace, která byla nasazena do kolekce, nasazení bude také odebráno.
Další informace o položkách konfigurace najdete v tématu Úvod do dodržování předpisů Nastavení v Správce konfigurace.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Odebrání položky pomocí ID
PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"
Tento příkaz odebere položku konfigurace se zadaným identifikátorem.
Příklad 2: Odebrání položky pomocí názvu
PS XYZ:\> Remove-CMConfigurationItem -Name "ConfigItem76"
Tento příkaz odebere položku konfigurace s názvem ConfigItem76.
Příklad 3: Odebrání položky pomocí proměnné
PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj
První příkaz načte položku konfigurace se zadaným identifikátorem a uloží ji do $CIObj proměnné.
Druhý příkaz odebere položku uloženou v proměnné $CIObj.
PARAMETERS
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Vynutí spuštění příkazu bez předchozího potvrzení uživatele.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Určuje pole identifikátorů pro jednu nebo více položek konfigurace. Můžete použít seznam oddělený čárkami.
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
Určuje objekt položky konfigurace. K získání objektu položky konfigurace můžete použít rutinu 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
Určuje pole názvů položek konfigurace.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
System.Object
POZNÁMKY
RELATED LINKS
Úvod do dodržování Nastavení v Správce konfigurace
Get-CMConfigurationItemXMLDefinition