Get-CMConfigurationItem
获取 Configuration Manager 配置项。
语法
Get-CMConfigurationItem
[-Fast]
[[-Name] <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMConfigurationItem
[-Fast]
[-Id] <Int32>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
说明
Get-CMConfigurationItem cmdlet 获取 Configuration Manager 中的配置项对象。 您可以使用此 cmdlet 获取供其他 cmdlet 使用的项目。 例如,您可以获取配置项,以便可以使用Set-CMConfigurationItem更改其设置。
配置项包含一个或多个设置以及合规性规则。 有关配置项详细信息,请参阅 Configuration Manager 中的合规性设置简介。
备注
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:使用名称获取项
PS XYZ:\> Get-CMConfigurationItem -Name "ConfigItem76"
此命令获取名为 ConfigItem76 的配置项。
示例 2:获取要用于其他 cmdlet 的项
PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj
第一个命令获取具有指定标识符的配置项,并存储到 $CIObj 变量中。
第二个命令删除 $CIObj 中的项。
参数
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Fast
指示 cmdlet 不会自动刷新延迟属性。
延迟属性包含检索效率相对低的值,这可能会导致额外的网络流量并减少 cmdlet 性能。 如果不需要延迟属性,应指定此参数。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符,并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定一个或多个配置项的标识符数组。 可以使用逗号分隔列表。
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名称
指定配置项的名称数组。 可以使用逗号分隔列表。
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
输入
无
输出
IResultObject[]
IResultObject