New-CMClientSetting
Creates customized client settings.
Parameter Set: New
New-CMClientSetting -Name <String> [-Description <String> ] [-Type <Types> {Default | Device | User} ] [-Confirm] [-WhatIf] [ <CommonParameters>]
The New-CMClientSetting cmdlet creates a collection of customized settings for Microsoft System Center 2012 SP1 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 (https://go.microsoft.com/fwlink/?LinkId=266226) on TechNet.
Specifies a description of the content of the new settings.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
Specifies a name for customized client settings.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
Specifies the type of customized settings. Valid values are: 1 (device) or 2 (user).
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
Prompts you for confirmation before running the cmdlet.
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 is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
The input type is the type of the objects that you can pipe to the cmdlet.
The output type is the type of the objects that the cmdlet emits.
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.
PS C:\> New-CMClientSetting -Name "Win08ClientSettings" -Description "Windows 8 Client Computers Settings" -Type 1