New-CMClientSettingDeployment

  • リファレンス
モジュール:
ConfigurationManager

カスタム クライアント設定を展開します。

構文

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