Dela via


Remove-CMConfigurationPolicy

SYNOPSIS

Tar bort en konfigurationsprincip.

SYNTAX

SearchByValue (standard)

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

SearchById

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

SearchByName

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

DESCRIPTION

Cmdleten Remove-CMConfigurationPolicy tar bort en konfigurationsprincip. En konfigurationsprincip kan vara en e-postprofil, en brandväggsprincip eller andra. Se avsnittet Alias för ytterligare principtyper som du kan använda den här cmdleten för att ta bort.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Ta bort en konfigurationsprincip efter ID

PS XYZ:\> Remove-CMConfigurationPolicy -ID 16777454 -Force

Det här kommandot tar bort konfigurationsprincipen med CI_ID 16777454 utan att användaren uppmanas att bekräfta.

Exempel 2: Ta bort en konfigurationsprincip efter namn

PS XYZ:\> Get-CMcertificateProfilePfx -Name "CertProf1" | Remove-CMConfigurationPolicy

Det här kommandot hämtar PFX-certifikatprofilobjektet med namnet CertProf01 och använder pipelineoperatorn för att skicka objektet till Remove-CMConfigurationPolicy, vilket tar bort certifikatprofilen.

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 be om användarbekrä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 CI__ID en konfigurationsprincip.

Type: Int32
Parameter Sets: SearchById
Aliases: CIId, CI_ID

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

-InputObject

Anger ett konfigurationsprincipobjekt. Om du vill hämta ett konfigurationsprincipobjekt använder du Get-CMConfigurationPolicy cmdlet.

Type: IResultObject
Parameter Sets: SearchByValue
Aliases:

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

-Name

Anger en matris med namn på konfigurationsprinciper.

Type: String[]
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName

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

-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

Copy-CMConfigurationPolicy

Get-CMConfigurationPolicy