Share via

Get-CMComplianceSetting

  • 参考
模块:
ConfigurationManager

获取配置项目的设置。

语法

Get-CMComplianceSetting
   [-Fast]
   [-Id] <Int32>
   [-SettingName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMComplianceSetting
   [-Fast]
   -InputObject <IResultObject>
   [-SettingName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMComplianceSetting
   [-Fast]
   [-Name] <String>
   [-SettingName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 获取配置项目的设置。 设置表示在客户端设备上评估合规性的业务或技术条件。 在引用计算机上配置新设置或浏览到现有设置。 有关详细信息，请参阅 Configuration Manager 中的符合性设置入门。

注意

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

示例

示例 1：获取配置项目中设置的位置

此示例查询名为 appevents 的设置 以获取配置项目 Windows 运行状况检查 ，并仅返回 location 属性。 此属性包括设置的注册表或文件路径。

Get-CMComplianceSetting -Name "Windows health check" -SettingName "appevents" -Fast | Select-Object Location

参数

-DisableWildcardHandling

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

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

-Fast

添加此参数以不自动刷新延迟属性。 延迟属性包含检索效率相对较低的值。 获取这些属性可能会导致额外的网络流量并降低 cmdlet 性能。

如果不使用此参数，cmdlet 将显示警告。 若要禁用此警告，请设置 $CMPSSuppressFastNotUsedCheck = $true。

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。 例如，258895。

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

-InputObject

指定具有要获取的设置的配置项目对象。 若要获取此对象，请使用 Get-CMConfigurationItem。

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

-Name

指定具有要获取的设置的配置项目的名称。

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

-SettingName

在配置项目中指定设置的名称。 此值与控制台中配置项目属性的“设置”选项卡上的“名称”值相同。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItemSetting