New-CMSettingDeployment

  • 參考
模組:
ConfigurationManager

將設定 policy 物件部署至集合。

Syntax

New-CMSettingDeployment
   [-CMSetting] <CMSettings>
   [-Schedule <IResultObject>]
   [-OverrideServiceWindows]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

將設定 policy 物件部署至集合。 例如，部署 BitLocker 管理原則或 Microsoft Defender 應用程式控制原則。 若要建立自訂排程，請使用 CMSchedule Cmdlet。 若要取得集合，請使用 CMCollection Cmdlet。

範例

範例1：將 BitLocker 管理物件部署至所有桌面伺服器及伺服器用戶端

本範例會依名稱取得 BitLocker 管理設定物件，並將該物件儲存在 $setting 變數中。 然後，它會依名稱取得集合，並將該物件儲存在 $collection 變數中。 它會使用 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 應用程式控制項設定

這個範例也會使用 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

指定要部署的 settings 物件。

Type:CMSettings
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-CollectionId

指定集合的識別碼做為部署的目標。

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

-CollectionName

指定集合的名稱做為部署的目標。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。

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

-OverrideServiceWindows

當您新增此參數時，用戶端可以修復維護時段以外的設定。

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

-Schedule

指定要套用至部署的排程物件。 若要建立自訂排程，請使用 CMSchedule Cmdlet。

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

-集合

指定集合物件做為部署的目標。 若要取得集合，請使用 CMCollection Cmdlet。

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

輸入

PowerShell ConfigurationManagement CMSettings （SimplifiedSettings）。

輸出

SettingsDeployment PowerShell ConfigurationManagement 中的 SettingsDeployment