Start-CMClientSettingDeployment

Start-CMClientSettingDeployment

Deploys client settings to devices in a collection.

構文

Parameter Set: SearchByClientSettingId_CollectionId
Start-CMClientSettingDeployment -ClientSettingId <String> -CollectionId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByClientSettingId_CollectionName
Start-CMClientSettingDeployment -ClientSettingId <String> -CollectionName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByClientSettingId_CollectionValue
Start-CMClientSettingDeployment -ClientSettingId <String> -Collection <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByClientSettingName_CollectionId
Start-CMClientSettingDeployment -ClientSettingName <String> -CollectionId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByClientSettingName_CollectionName
Start-CMClientSettingDeployment -ClientSettingName <String> -CollectionName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByClientSettingName_CollectionValue
Start-CMClientSettingDeployment -ClientSettingName <String> -Collection <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByClientSettingValue_CollectionId
Start-CMClientSettingDeployment -ClientSetting <IResultObject> -CollectionId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByClientSettingValue_CollectionName
Start-CMClientSettingDeployment -ClientSetting <IResultObject> -CollectionName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByClientSettingValue_CollectionValue
Start-CMClientSettingDeployment -ClientSetting <IResultObject> -Collection <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Start-CMClientSettingDeployment cmdlet deploys client settings to devices in a Microsoft System Center 2012 Configuration Manager collection. Specify the client setting object by using its name or ID, or you can use the Get-CMClientSetting cmdlet to get a client setting object. Specify the collection to apply the settings to by using its name or ID, or you can use the Get-CMDeviceCollection cmdlet to get a device collection.

For more information about client settings, see About Client Settings in Configuration Manager (https://go.microsoft.com/fwlink/?LinkId=266226) on TechNet.

パラメーター

-ClientSetting<IResultObject>

Specifies a client setting object. To obtain a client setting object, use the Get-CMClientSetting cmdlet.

-ClientSettingId<String>

Specifies the ID of a client setting object.

-ClientSettingName<String>

Specifies the name of a client setting object.

-Collection<IResultObject>

Specifies a Configuration Manager collection object. To obtain a collection object, use the Get-CMDeviceCollection cmdlet. Configuration Manager applies the client settings to the members of this collection.

-CollectionId<String>

Specifies the ID of a Configuration Manager collection. Configuration Manager applies the client settings to the members of this collection.

-CollectionName<String>

Specifies the name of a Configuration Manager collection. Configuration Manager applies the client settings to the members of this collection.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Deploy a client setting object by using its ID to a named collection

This command starts deployment of the client setting object that has the ID CSI1023 for the collection named General Computer Collection.

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

Example 2: Deploy a client setting object by using a variable

The first command gets a client setting object that has the ID CSI1023, and saves it in the $CSID variable.

The second command starts deployment of the client setting object in the $CSID variable to the collection named General Computer Collection.

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

関連トピック

Get-CMClientSetting

Get-CMDeviceCollection