description | external help file | Module Name | ms.date | schema | title |
---|---|---|---|---|---|
Creates customized client settings. |
AdminUI.PS.dll-Help.xml |
ConfigurationManager |
05/05/2019 |
2.0.0 |
New-CMClientSetting |
Creates customized client settings.
New-CMClientSetting [-Description <String>] -Name <String> -Type <Types> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
The New-CMClientSetting cmdlet creates a collection of customized settings for Configuration Manager client computers. After you create the customized settings and deploy them to client computer collections, the customized settings override the default client settings for that collection.
For more information about client settings, see About Client Settings in Configuration Manager.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
PS XYZ:\> New-CMClientSetting -Name "Win08ClientSettings" -Description "Windows 8 Client Computers Settings" -Type 1
AgentConfigurations: {}
AssignmentCount: 0
CreatedBy: Contoso\DChew
DateCreated: 8/04/2012 4:40:03 PM
DateModified: 8/04/2012 4:40:03 PM
Description: Windows 8 Client Computers Settings
Enabled: False
FeatureType: 1
Flags: 0
LastModifiedBy: Contoso\DChew
Name: Win08ClientSettings
Priority: 0
SecuredScopeNames: {Default}
Settings ID: 16777220
Type: 1
UniqueID: {0CCA6700-AE5E-4949-8FBC-AA6719775CC3}
This command creates customized device settings for the group of client computers that run Windows� 8. After the new collection of settings is created, the command displays an unpopulated list of setting properties. To refresh and view a populated list of properties, use Get-CMClientSetting. The output for this example shows a populated list.
Specifies a description of the content of the new settings.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies a name for customized client settings.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the type of customized settings. Valid values are: 1 (device) or 2 (user).
Type: Types
Parameter Sets: (All)
Aliases:
Accepted values: Default, Device, User
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
About Client Settings in Configuration Manager
Set-CMClientSettingBackgroundIntelligentTransfer Set-CMClientSettingClientCache Set-CMClientSettingClientPolicy Set-CMClientSettingCloudService Set-CMClientSettingComplianceSetting Set-CMClientSettingComputerAgent Set-CMClientSettingComputerRestart Set-CMClientSettingDeliveryOptimization Set-CMClientSettingEndpointProtection Set-CMClientSettingEnrollment Set-CMClientSettingGeneral Set-CMClientSettingHardwareInventory Set-CMClientSettingMeteredInternetConnection Set-CMClientSettingPowerManagement Set-CMClientSettingRemoteTool Set-CMClientSettingSoftwareCenter Set-CMClientSettingSoftwareDeployment Set-CMClientSettingSoftwareInventory Set-CMClientSettingSoftwareMetering Set-CMClientSettingSoftwareUpdate Set-CMClientSettingStateMessaging Set-CMClientSettingUserAndDeviceAffinity