New-CMBaselineDeployment

  • 参考
模块:
ConfigurationManager

创建基线部署。

语法

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 部署到 ID 为 PS1000023 的集合。

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

参数

-Collection

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

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

-CollectionId

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

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

-CollectionName

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

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-EnableEnforcement

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

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

-ForceWildcardHandling

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

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

-GenerateAlert

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

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

-Id

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

Type:Int32
Aliases:CIId, CI_ID, BaselineId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Aliases:Baseline
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MonitoredByScom

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

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

-Name

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

Type:String
Aliases:LocalizedDisplayName, BaselineName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OverrideServiceWindow

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

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

-ParameterValue

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

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

-PostponeDateTime

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

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

-Schedule

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

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object