通过

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

指定要部署的设置对象。

类型:CMSettings
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Collection

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

类型:IResultObject
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CollectionId

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

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