New-CMClientSettingDeployment
SYNOPSIS
Distribuera en anpassad klientinställning.
SYNTAX
SearchByClientSettingName (standard)
New-CMClientSettingDeployment -Name <String> [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByClientSettingId
New-CMClientSettingDeployment -Id <String> [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByClientSettingValue
New-CMClientSettingDeployment -InputObject <IResultObject> [-Collection <IResultObject>]
[-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Använd den här cmdleten för att distribuera 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: Distribuera ett klientinställningsobjekt med hjälp av dess ID till en namngiven samling
New-CMClientSettingDeployment -Id "16777225" -CollectionName "General Computer Collection"
PARAMETERS
-Samling
Ange ett samlingsobjekt som mål för distributionen. Hämta det här objektet med hjälp av cmdleten Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Ange ett ID för samlingen som ska vara mål för den här distributionen. Det här värdet är ett standardinsamlings-ID, till exempel XYZ00042
.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Ange ett samlingsnamn för distributionen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-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
-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
Ange ID för de anpassade klientinställningar som ska distribueras. Detta ID är Inställningar-ID:t i -konsolen och egenskapen SettingsID på 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: SearchByClientSettingId
Aliases: ClientSettingId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Ange ett objekt för anpassade klientinställningar som ska distribueras. Hämta det här objektet med hjälp av cmdleten Get-CMClientSetting.
Type: IResultObject
Parameter Sets: SearchByClientSettingValue
Aliases: ClientSetting
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Ange namnet på de anpassade klientinställningar som ska distribueras.
Type: String
Parameter Sets: SearchByClientSettingName
Aliases: ClientSettingName
Required: True
Position: Named
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: 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.