Set-CMBaseline

模块:

ConfigurationManager

更改配置基线的设置。

语法

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Id <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 更改Configuration Manager中配置基线的设置。 配置基线可以包括以下类型的配置数据：

• 配置项目
• 其他配置基线
• 软件更新

Configuration Manager客户端根据此基线评估其符合性。 如果所有指定项都合规，则基线本身将评估为符合。 还可以包括可选项，这些项仅在设备上存在相关应用程序或设置时才进行评估。

有关详细信息，请参阅在 Configuration Manager 中创建配置基线。

注意

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

示例

示例 1：配置配置基线

此示例首先使用 Get-CMConfigurationItem cmdlet 获取一系列配置项目， () 的 API。

然后，它将 cmdlet 参数 展开 到 parameters 变量中。 不需要对参数进行 splat，它只是便于读取如此长的命令行的参数。

最后一个命令使用新名称和说明配置 PSTestBaseLine 基线，删除类别并添加CI。

$objPSTestWinAppCI = Get-CMConfigurationItem -Name PSTestWinAppCI
$objPSTestWinAppCI2 = Get-CMConfigurationItem -Name PSTestWinAppCI2
$objPSTestWinOSCI = Get-CMConfigurationItem -Name PSTestWinOSCI
$objPSTestWinAppCI3 = Get-CMConfigurationItem -Name PSTestWinAppCI3
$objPSTestWinAppCI4 = Get-CMConfigurationItem -Name PSTestWinAppCI4
$objPSTestMDCI = Get-CMConfigurationItem -Name PSTestMDCI
$objPSTestMacCI = Get-CMConfigurationItem -Name PSTestMacCI

$parameters = @{
  Name = "PSTestBaseLine"
  NewName = "PSTestBaseLineNew"
  Description = "DCM Testing New"
  RemoveCategory = ("IT Infrastructure")
  AddRequiredConfigurationItems = ($objPSTestWinAppCI4.CI_ID,$objPSTestMDCI.CI_ID)
  AddProhibitedConfigurationItems = ($objPSTestWinAppCI.CI_ID)
  AddOSConfigurationItems = ($objPSTestWinOSCI.CI_ID,$objPSTestMacCI.CI_ID)
  AddOptionalConfigurationItems = ($objPSTestWinAppCI2.CI_ID,$objPSTestWinAppCI3.CI_ID)
}

Set-CMBaseline @parameters

示例 2：添加自定义类别

此示例首先使用 New-CMCategory cmdlet 创建自定义基线类别 Accounting。 然后，它会配置 会计基线 以添加新类别。

$category = New-CMCategory -CategoryType BaselineCategories -Name "Accounting"
Set-CMBaseline -Name "Accounting baseline" -AddCategory $category.LocalizedCategoryInstanceName

参数

-AddBaseline

指定要作为配置数据添加到目标基线的基线 ID 数组。 此值是基线 的 CI_ID 属性，例如 16777516。

Type:	String[]
Aliases:	AddBaselines
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddCategory

指定要添加到配置基线的配置类别名称数组。 这些类别改进了搜索和筛选。 默认情况下，站点包括以下配置基线类别：

• Client
• IT 基础结构
• 业务线
• 服务器

若要使用另一个类别，请先使用 New-CMCategory cmdlet 和 -CategoryType BaselineCategories 参数添加它。

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

-AddOptionalConfigurationItem

指定要使用 可选 用途添加的配置项 ID 的数组。 仅当设备上存在相关应用程序时，Configuration Manager客户端才会评估可选项。

此值是配置项目的 CI_ID 属性，例如 16777514。

Type:	String[]
Aliases:	AddOptionalConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddOSConfigurationItem

指定要添加的 OS 类型的配置项 ID 的数组。 此值是配置项目的 CI_ID 属性，例如 16777514。

Type:	String[]
Aliases:	AddOSConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddProhibitedConfigurationItem

指定要添加的具有 禁止 用途的配置项目 ID 数组。 此值是配置项目的 CI_ID 属性，例如 16777514。

Type:	String[]
Aliases:	AddProhibitedConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddRequiredConfigurationItem

指定要添加的具有 所需 用途的配置项 ID 的数组。 此值是配置项目的 CI_ID 属性，例如 16777514。

Type:	String[]
Aliases:	AddRequiredConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddSoftwareUpdate

指定要添加的软件更新 ID 的数组。

Type:	String[]
Aliases:	AddSoftwareUpdates
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowComanagedClients

将此参数设置为 以 $true 始终应用此基线，即使对于共同管理的客户端也是如此。

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

-ClearBaseline

添加此参数以从目标基线中删除所有作为评估条件的基线。 若要删除单个基线，请使用 RemoveBaseline 参数。

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

-ClearOptionalConfigurationItem

添加此参数以从目标基线中删除所有 可选 配置项目作为评估条件。 若要删除单个可选 CIS，请使用 RemoveOptionalConfigurationItem 参数。

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

-ClearOSConfigurationItem

添加此参数以从目标基线中删除所有 OS 配置项目作为评估条件。 若要删除单个 OS CIS，请使用 RemoveOSConfigurationItem 参数。

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

-ClearProhibitedConfigurationItem

添加此参数以从目标基线中删除所有 禁止 的配置项目作为评估条件。 若要删除单个禁止的 CIS，请使用 RemoveProhibitedConfigurationItem 参数。

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

-ClearRequiredConfigurationItem

添加此参数以从目标基线中删除所有 必需的 配置项作为评估条件。 若要删除单个所需的CI，请使用 RemoveRequiredConfigurationItem 参数。

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

-ClearSoftwareUpdate

添加此参数以从目标基线中删除所有软件更新作为评估条件。 若要删除单个软件更新，请使用 RemoveSoftwareUpdate 参数。

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

-Confirm

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

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

-Description

指定配置基线的可选说明以帮助识别它。

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

-DesiredConfigurationDigestPath

指定存储为 XML 摘要的配置数据的路径。

Type:	String
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

-ForceWildcardHandling

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

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

-Id

指定要配置的配置基线CI_ID。 例如，16777516。

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

-InputObject

指定要配置的配置基线对象。 若要获取此对象，请使用 Get-CMBaseline cmdlet。

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

-Name

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

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

-NewName

为配置基线指定新名称。 使用此参数重命名目标基线。

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

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-RemoveBaseline

指定要从目标基线中删除的基线 ID 数组作为配置数据。 此值是基线 的 CI_ID 属性，例如 16777516。 若要从此基线中删除所有基线作为配置数据，请使用 ClearBaseline 参数。

Type:	String[]
Aliases:	RemoveBaselines
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveCategory

指定要从配置基线中删除的配置类别名称数组。

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

-RemoveOptionalConfigurationItem

指定要从目标基线中删除的 可选 CI ID 数组作为配置数据。 此值是配置项目的 CI_ID 属性，例如 16777514。 若要从此基线中删除所有可选配置项目，请使用 ClearOptionalConfigurationItem 参数。

Type:	String[]
Aliases:	RemoveOptionalConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveOSConfigurationItem

指定要从目标基线中删除的 OS CI ID 数组作为配置数据。 此值是配置项目的 CI_ID 属性，例如 16777514。 若要从此基线中删除所有 OS 配置项目，请使用 ClearOSConfigurationItem 参数。

Type:	String[]
Aliases:	RemoveOSConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveProhibitedConfigurationItem

指定要从目标基线中删除的 禁止 的 CI ID 数组作为配置数据。 此值是配置项目的 CI_ID 属性，例如 16777514。 若要从此基线中删除所有禁止的配置项目，请使用 ClearProhibitedConfigurationItem 参数。

Type:	String[]
Aliases:	RemoveProhibitedConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveRequiredConfigurationItem

指定要从目标基线中删除的 所需 CI ID 数组作为配置数据。 此值是配置项目的 CI_ID 属性，例如 16777514。 若要从此基线中删除所有必需的配置项目，请使用 ClearRequiredConfigurationItem 参数。

Type:	String[]
Aliases:	RemoveRequiredConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSoftwareUpdate

指定要从目标基线中删除的软件更新 ID 数组作为配置数据。 若要从此基线中删除所有软件更新，请使用 ClearSoftwareUpdate 参数。

Type:	String[]
Aliases:	RemoveSoftwareUpdates
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:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Disable-CMBaseline
• Enable-CMBaseline
• Export-CMBaseline
• Get-CMBaseline
• Import-CMBaseline
• New-CMBaseline
• Remove-CMBaseline
• Get-CMBaselineXMLDefinition
• Get-CMBaselineSummarizationSchedule
• 在 Configuration Manager 中创建配置基线