Dela via


Remove-CMSettingDeployment

SYNOPSIS

Ta bort en distribution för ett inställningsprincipobjekt.

SYNTAX

Remove-CMSettingDeployment [-CMSettingsDeployment] <SettingsDeployment> [-Force] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

Ta bort en distribution för ett inställningsprincipobjekt. Ta till exempel bort distributionen av en BitLocker-hanteringsprincip eller en Microsoft Defender Application Control princip.

EXAMPLES

Exempel 1: Ta bort alla distributioner för ett BitLocker-hanteringsinställningsobjekt

Det här exemplet hämtar först ett BitLocker-hanteringsinställningsobjekt. Den använder sedan pipe-operatorn för att hämta alla distributioner för det principobjektet och tar bort dessa distributioner.

Get-CMBlmSetting -Name "My BitLocker settings" | Get-CMSettingDeployment | Remove-CMSettingDeployment

Exempel 2: Ta bort alla distributioner till en specifik samling för ett Microsoft Defender Application Control-inställningsobjekt

Det här exemplet hämtar först ett Microsoft Defender Application Control inställningsobjekt. Den använder sedan pipe-operatorn för att hämta alla distributioner för det principobjektet. Where-Object-satsen filtrerar listan över distributioner till dem till samlingen Alla skrivbords- och serverklienter och tar bort dessa distributioner.

Get-CMWdacSetting -Name "My App Control settings" | Get-CMSettingDeployment | Where-Object { $_.CollectionId -eq (Get-CMCollection -Name "All Desktop and Server Clients").CollectionId } | Remove-CMSettingDeployment

PARAMETERS

-CMSettingsDeployment

Ange inställningsdistributionsobjektet som ska konfigureras. Hämta distributionsobjektet med hjälp av cmdleten Get-CMSettingDeployment.

Type: SettingsDeployment
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
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

Kör kommandot utan att be om 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

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.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment

OUTPUTS

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment

ANTECKNINGAR

Get-CMSettingDeployment

New-CMSettingDeployment

Set-CMSettingDeployment