New-CMSettingDeployment

  • 参考
模块:
ConfigurationManager

将设置策略对象部署到集合。

语法

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

说明

将设置策略对象部署到集合。 例如，部署 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

指定要部署的设置对象。

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

-Collection

将集合对象指定为部署的目标。 若要获取集合，请使用 Get-CMCollection cmdlet。

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

-CollectionId

指定集合的 ID 作为部署的目标。

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

指定要应用于部署的计划对象。 若要创建自定义计划，请使用 New-CMSchedule cmdlet。

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

输入

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings

输出

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment