Remove-CMClientSettingDeployment

SYNOPSIS

Ta bort en specifik distribution av en anpassad klientinställning.

SYNTAX

SearchByValue (standard)

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

SearchByIdMandatory

Remove-CMClientSettingDeployment -CollectionId <String> -ClientSettingsId <String> [-Force]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Använd den här cmdleten för att ta bort en specifik distribution av en anpassad klientinställning. När du distribuerar anpassade inställningar åsidosätter de standardklientinställningarna. Anpassade klientinställningar med högre prioritet kan också åsidosätta andra inställningar. Mer information finns i Skapa och distribuera anpassade klientinställningar.

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 klientinställningsdistribution efter ID

Det här exemplet tar bort distributionen av klientinställningarna för fjärrstyrning till samlingen med ID XYZ0003F.

$clientSettingId = (Get-CMClientSetting -Name "Remote control").SettingsID

Remove-CMClientSettingDeployment -CollectionID 'XYZ0003F' -ClientSettingsID $clientSettingId

PARAMETERS

-ClientSettingsId

Ange ID för de klientinställningar som distribueras. Det här ID:t Inställningar ID:t i -konsolen och egenskapen SettingsID för SMS_ClientSettings WMI-klassen.

Du kan använda cmdleten Get-CMClientSetting för att hämta den här egenskapen. Till exempel (Get-CMClientSetting -Name "Remote control").SettingsID

Type: String
Parameter Sets: SearchByIdMandatory
Aliases:

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

-CollectionId

Ange samlings-ID:t som klientinställningarna ska distribueras till. Det här värdet är standardinsamlingens ID-format, till exempel XYZ00042 .

Type: String
Parameter Sets: SearchByIdMandatory
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

Required: False
Position: Named
Default value: None
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

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

-InputObject

Ange ett distributionsobjekt för klientinställningar som ska tas bort. Hämta det här objektet med cmdleten Get-CMClientSettingDeployment.

Type: IResultObject
Parameter Sets: SearchByValue
Aliases: Deployment

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

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMClientSettingDeployment

New-CMClientSettingDeployment

Get-CMClientSetting

Skapa och distribuera anpassade klientinställningar