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