共用方式為

New-CMSettingDeployment

  • 參考
模組:
ConfigurationManager

將設定原則物件部署至集合。

語法

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

指定要部署的設定物件。

類型: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