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.