New-CMClientSettingDeployment
カスタム クライアント設定を展開します。
構文
New-CMClientSettingDeployment
-Name <String>
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMClientSettingDeployment
-Id <String>
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMClientSettingDeployment
-InputObject <IResultObject>
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、カスタム クライアント設定を展開します。 カスタム設定を展開すると、既定のクライアント設定が上書きされます。 優先度が高いカスタム クライアント設定は、他の設定よりも優先される場合があります。 詳細については、「カスタム クライアント設定の 作成と展開」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: ID を使用してクライアント設定オブジェクトを名前付きコレクションに展開する
New-CMClientSettingDeployment -Id "16777225" -CollectionName "General Computer Collection"
パラメーター
-Collection
展開のターゲットとしてコレクション オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMCollection コマンドレットを使用 します。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
この展開を対象とするコレクションの ID を指定します。 この値は、たとえば、標準コレクション ID です XYZ00042
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
この展開を対象とするコレクション名を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
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 |
-Id
展開するカスタム クライアント設定の ID を指定します。 この ID は 、コンソール設定 ID、 および WMI クラスのSettingsID プロパティSMS_ClientSettingsです。
Get-CMClientSetting コマンドレットを使用して、このプロパティを取得できます。 たとえば、(Get-CMClientSetting -Name "Remote control").SettingsID
のように指定します。
Type: | String |
Aliases: | ClientSettingId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
展開するカスタム クライアント設定オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMClientSetting コマンドレットを使用 します。
Type: | IResultObject |
Aliases: | ClientSetting |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
展開するカスタム クライアント設定の名前を指定します。
Type: | String |
Aliases: | ClientSettingName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object