New-CMClientSetting

建立自訂的用戶端設定。

Syntax

New-CMClientSetting
   [-Description <String>]
   -Name <String>
   -Type <Types>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

CMClientSetting Cmdlet 會為 Configuration Manager 用戶端電腦建立自訂設定的集合。 在您建立自訂設定並將其部署至用戶端電腦集合之後,自訂設定會覆寫該集合的預設用戶端設定。

如需用戶端設定的詳細資訊,請參閱關於用戶端設定在 Configuration Manager 中

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\> 。 如需詳細資訊,請參閱 快速入門。

範例

範例1:建立用戶端設定的自訂集合

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}

這個命令會為執行 Windows 8 的用戶端電腦群組建立自訂的裝置設定。 在建立新的設定集合之後,此命令會顯示設定屬性的尚未填入清單。 若要重新整理和查看已填入的屬性清單,請使用 CMClientSetting。 這個範例的輸出會顯示一個填入的清單。

參數

-Confirm

執行 Cmdlet 之前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

會指定新設定內容的描述。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Type

會指定自訂設定的類型。 有效的值為: 1 (裝置) 或 2 (使用者) 。

Type:Types
Accepted values:Default, Device, User
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-名稱

指定自訂用戶端設定的名稱。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

輸入

輸出

IResultObject