New-CMBaselineDeployment

创建基线部署。

语法

New-CMBaselineDeployment
   [-EnableEnforcement <Boolean>]
   [-GenerateAlert <Boolean>]
   [-InputObject] <IResultObject>
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   [-Schedule <IResultObject>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMBaselineDeployment
   [-EnableEnforcement <Boolean>]
   [-GenerateAlert <Boolean>]
   [-Id] <Int32>
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   [-Schedule <IResultObject>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMBaselineDeployment
   [-EnableEnforcement <Boolean>]
   [-GenerateAlert <Boolean>]
   [-MonitoredByScom <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   [-Schedule <IResultObject>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

部署配置基线。 使用 Get-CMBaseline cmdlet 获取基线。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:将基线部署到具有相同命名前缀的集合

此示例使用 Get-CMBaseline 获取配置基线,并将其存储在 变量$BaselineName中。 然后,它使用 Get-CMCollection 获取名称以“Collection_Name”开头的所有集合的列表,并将其存储在变量 $DeployToCollections。 接下来,它使用 New-CMSchedule cmdlet 创建部署计划。 存储所有必需信息后,该示例将循环访问每个集合,并使用 New-CMBaselineDeployment 部署基线。

$BaselineName = Get-CMBaseline -Name 'ConfigMgr Baseline'
$DeployToCollections = Get-CMCollection -Name 'Collection_Name*' | Sort-Object -Property "Name"
$BaselineSchedule = New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1

foreach ($Collection in $DeployToCollection)
             {
             New-CMBaselineDeployment -InputObject $BaselineName -CollectionID $Collection.CollectionId -Schedule $BaselineSchedule
             Write-Output "Created Deployment for $($BaselineName.LocalizedDisplayName) on $($Collection.Name)"
             }

示例 2:将基线部署到一个集合

首先,此示例创建一个简单的计划。 然后,它将基线 MY_Baseline 部署到具有 PS1000023 ID 的集合。

$BaselineSchedule = New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1
New-CMBaselineDeployment -Name "MY_Baseline" -CollectionID "PS1000023" -Schedule $BaselineSchedule

参数

-Collection

将集合对象指定为基线部署的目标。

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

-CollectionId

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

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

-CollectionName

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

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-EnableEnforcement

如果 $true为 ,请在支持时修正不符合规则。

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

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

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

-GenerateAlert

如果 $true为 ,则生成警报。

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

-Id

指定要部署的配置基线的 ID。

类型:Int32
别名:CIId, CI_ID, BaselineId
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-InputObject

指定要部署的配置基线对象。 使用 Get-CMBaseline cmdlet 获取基线。

类型:IResultObject
别名:Baseline
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-MonitoredByScom

如果 $true为 ,则生成 System Center Operations Manager 警报。

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

-Name

指定要部署的配置基线的名称。

类型:String
别名:LocalizedDisplayName, BaselineName
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-OverrideServiceWindow

如果 $true为 ,则允许客户端在维护时段外修正此基线。

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

-ParameterValue

如果使用 -GenerateAlert 参数,请将整数值指定为百分比 (0-100) 。 当此配置基线的符合性低于此值时,站点将生成警报。

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

-PostponeDateTime

使用 -GenerateAlert 参数时,此参数对应于配置基线的日期和时间属性。

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

-Schedule

指定客户端评估此配置基线时的计划对象。 使用 New-CMSchedule cmdlet 创建计划。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object