Dela via


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 SettingsIDSMS_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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMClientSettingDeployment

Remove-CMClientSettingDeployment

Get-CMClientSetting

Skapa och distribuera anpassade klientinställningar