New-CMSettingDeployment
將設定原則物件部署至集合。
語法
New-CMSettingDeployment
[-CMSetting] <CMSettings>
[-Schedule <IResultObject>]
[-OverrideServiceWindows]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Description
將設定原則物件部署至集合。 例如，部署 BitLocker 管理原則或Microsoft Defender 應用程控原則。 若要建立自定義排程，請使用 New-CMSchedule Cmdlet。 若要取得集合，請使用 Get-CMCollection Cmdlet。
範例
範例 1：將 BitLocker 管理物件部署到所有桌面和伺服器用戶端
這個範例會依名稱取得 BitLocker 管理設定物件，並將該物件儲存在 $setting 變數中。 然後，它會依名稱取得集合，並將該物件儲存在 $collection 變數中。 它會使用 New-CMSettingDeployment Cmdlet 將 BitLocker 管理設定物件部署到該集合。
$setting = Get-CMBlmSetting -Name "My BitLocker settings"
$collection = Get-CMCollection -Name "All Desktop and Server Clients"
New-CMSettingDeployment -CMSetting $setting -CollectionName $collection.Name範例 2：使用自定義排程部署 Windows Defender 應用程
此範例也會使用 New-CMSchedule Cmdlet 建立自定義排程。
$setting = Get-CMWdacSetting -Name "My App Control settings"
$collection = Get-CMCollection -Name "All Desktop and Server Clients"
$sched = New-CMSchedule -Start ((Get-Date).AddDays(-30)).ToString() -RecurCount 7 -RecurInterval Minutes
$dep = New-CMSettingDeployment -CMSetting $setting -Collection $collection -Schedule $sched參數
-CMSetting
指定要部署的設定物件。
- 針對 BitLocker 管理，請使用 Get-CMBlmSetting 或 New-CMBlmSetting Cmdlet。
- 針對 Microsoft Defender 應用程控，請使用 Get-CMWdacSetting 或 New-CMWdacSetting Cmdlet。
| 類型: | CMSettings |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Collection
指定集合物件做為部署的目標。 若要取得集合，請使用 Get-CMCollection Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionId
指定集合的識別碼做為部署的目標。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
指定集合的名稱做為部署的目標。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OverrideServiceWindows
當您新增此參數時，用戶端可以補救維護期間以外的設定。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Schedule
指定要套用至部署的排程物件。 若要建立自定義排程，請使用 New-CMSchedule Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings
輸出
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment