Start-CMClientSettingDeployment

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

(非推奨)コレクション内のデバイスにクライアント設定を展開します。

構文

Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

Start-CMClientSettingDeployment コマンドレットは、Configuration Manager コレクション内のデバイスにクライアント設定を展開します。 クライアント設定オブジェクトの名前または ID を使用して指定するか、 Get-CMClientSetting コマンドレットを使用してクライアント設定オブジェクトを取得できます。 名前または ID を使用して設定を適用するコレクションを指定するか、 Get-CMDeviceCollection コマンドレットを使用してデバイス コレクションを取得できます。

クライアント設定の詳細については、「 Configuration Manager のクライアント設定について」を参照してください。

重要

バージョン 2107 以降、このコマンドレットは非推奨となり、今後のリリースで削除される可能性があります。 代わりに、 New-CMClientSettingDeployment コマンドレットを 使用します。

例

例 1: ID を使用して名前付きコレクションにクライアント設定オブジェクトをデプロイする

PS XYZ:\> Start-CMClientSettingDeployment -ClientSettingId "CSI1023" -CollectionName "General Computer Collection"

このコマンドは、General Computer Collection という名前のコレクションの ID CSI1023を持つクライアント設定オブジェクトの展開を開始します。

例 2: 変数を使用してクライアント設定オブジェクトをデプロイする

PS XYZ:\> $CSID = Get-CMClientSetting -Id "CSI1023"
PS XYZ:\> Start-CMClientSettingDeployment -ClientSetting $CSID -CollectionName "General Computer Collection"

最初のコマンドは、ID CSI1023を持つクライアント設定オブジェクトを取得し、$CSID変数に保存します。

2 番目のコマンドは、$CSID変数内のクライアント設定オブジェクトの General Computer Collection という名前のコレクションへの展開を開始します。

パラメーター

-ClientSetting

クライアント設定オブジェクトを指定します。 クライアント設定オブジェクトを取得するには、 Get-CMClientSetting コマンドレットを 使用します。

型:IResultObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ClientSettingId

クライアント設定オブジェクトの ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClientSettingName

クライアント設定オブジェクトの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Collection

Configuration Manager コレクション オブジェクトを指定します。 コレクション オブジェクトを取得するには、 Get-CMDeviceCollection コマンドレットを 使用します。 Configuration Manager は、このコレクションのメンバーにクライアント設定を適用します。

型:IResultObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-CollectionId

Configuration Manager コレクションの ID を指定します。 Configuration Manager は、このコレクションのメンバーにクライアント設定を適用します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CollectionName

Configuration Manager コレクションの名前を指定します。 Configuration Manager は、このコレクションのメンバーにクライアント設定を適用します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object