Start-CMClientSettingDeployment
(已淘汰) 將用戶端設定部署至集合中的裝置。
語法
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。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ClientSettingId
指定客戶端設定物件的識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ClientSettingName
指定客戶端設定物件的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Collection
指定 Configuration Manager 集合物件。 若要取得集合物件，請使用 Get-CMDeviceCollection Cmdlet。 Configuration Manager 會將用戶端設定套用至此集合的成員。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-CollectionId
指定 Configuration Manager 集合的標識碼。 Configuration Manager 會將用戶端設定套用至此集合的成員。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
指定 Configuration Manager 集合的名稱。 Configuration Manager 會將用戶端設定套用至此集合的成員。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object