Share via

Start-CMClientSettingDeployment

  • 參考
模組:
ConfigurationManager

(已淘汰) 將用戶端設定部署至集合中的裝置。

Syntax

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>]

Description

Start-CMClientSettingDeployment Cmdlet 會將用戶端設定部署到Configuration Manager集合中的裝置。 使用用戶端設定物件的名稱或識別碼來指定用戶端設定物件，或者您可以使用 Get-CMClientSetting Cmdlet 來取得用戶端設定物件。 使用集合的名稱或識別碼指定要套用設定的集合，或者您可以使用 Get-CMDeviceCollection Cmdlet 來取得裝置集合。

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

重要事項

從 2107 版開始，此 Cmdlet 已被取代，並可能在未來的版本中移除。 請改用 New-CMClientSettingDeployment Cmdlet。

範例

範例 1：使用用戶端設定物件的識別碼部署至具名集合

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

此命令會開始部署識別碼為 CSI1023 的用戶端設定物件，以用於名為一般電腦集合的集合。

範例 2：使用變數部署用戶端設定物件

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

第一個命令會取得識別碼為 CSI1023 的用戶端設定物件，並將它儲存在$CSID變數中。

第二個命令會開始將$CSID變數中的用戶端設定物件部署到名為一般電腦集合的集合。

參數

-ClientSetting

指定用戶端設定物件。 若要取得用戶端設定物件，請使用 Get-CMClientSetting Cmdlet。

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ClientSettingId

指定用戶端設定物件的識別碼。

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

-ClientSettingName

指定用戶端設定物件的名稱。

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

-Collection

指定Configuration Manager集合物件。 若要取得集合物件，請使用 Get-CMDeviceCollection Cmdlet。 Configuration Manager會將用戶端設定套用至此集合的成員。

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CollectionId

指定Configuration Manager集合的識別碼。 Configuration Manager會將用戶端設定套用至此集合的成員。

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

-CollectionName

指定Configuration Manager集合的名稱。 Configuration Manager會將用戶端設定套用至此集合的成員。

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

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

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object