Get-CimClass

获取特定命名空间中的 CIM 类的列表。

语法

ComputerSet (默认值)

Get-CimClass
    [[-ClassName] <string>]
    [[-Namespace] <string>]
    [-Amended]
    [-OperationTimeoutSec <uint>]
    [-ComputerName <string[]>]
    [-MethodName <string>]
    [-PropertyName <string>]
    [-QualifierName <string>]
    [<CommonParameters>]

SessionSet

Get-CimClass
    [[-ClassName] <string>]
    [[-Namespace] <string>]
    -CimSession <CimSession[]>
    [-Amended]
    [-OperationTimeoutSec <uint>]
    [-MethodName <string>]
    [-PropertyName <string>]
    [-QualifierName <string>]
    [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

Get-CimClass cmdlet 检索特定命名空间中的 CIM 类列表。 如果没有提供类名,则 cmdlet 将返回命名空间中的所有类。 与 CIM 实例不同,CIM 类不包含从中检索它们的 CIM 会话或计算机名称。

示例

示例 1:获取所有类定义

此示例获取命名空间下的所有类定义 根/CIMV2

Get-CimClass

示例 2:获取具有特定名称的类

此示例获取名称中包含磁盘 单词 的类。

Get-CimClass -ClassName *Disk*

示例 3:获取具有特定方法名称的类

本示例获取以 win32 名称开头的类,并具有以 Term开头的方法名称。

Get-CimClass -ClassName Win32* -MethodName Term*

示例 4:获取具有特定属性名称的类

此示例获取以名称 Win32 开头的类,并具有名为 handle 的属性。

Get-CimClass -ClassName Win32* -PropertyName Handle

示例 5:获取具有特定限定符名称的类

此示例获取以名称 Win32开头的类,其名称中包含单词 Disk,并具有指定的限定符 Association

Get-CimClass -ClassName Win32*Disk* -QualifierName Association

示例 6:从特定命名空间获取类定义

本示例从指定的命名空间 根/StandardCimv2获取名称中包含单词 Net 的类定义。

Get-CimClass -Namespace root/StandardCimv2 -ClassName *Net*

示例 7:从远程服务器获取类定义

此示例从指定的远程服务器 Server01Server02获取名称中包含单词 Disk 的类定义。

Get-CimClass -ClassName *Disk* -ComputerName Server01, Server02

示例 8:使用 CIM 会话获取类

$s = New-CimSession -ComputerName Server01, Server02
Get-CimClass -ClassName *Disk* -CimSession $s

这组命令创建一个具有多台计算机的会话,并使用 $s cmdlet 将其存储在变量 New-CimSession 中,然后使用 Get-CimClass cmdlet 获取类。

参数

-Amended

指示从 CIM 查询返回的对象应包含修订的信息。 通常,修改后的信息是可本地化的信息,例如附加到 CIM 对象的对象和属性说明。 这对于将数值转换为人工可读值非常有用。

此参数已在 PowerShell 7.3 中添加。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-CimSession

在远程会话或远程计算机上运行 cmdlet。 输入计算机名或会话对象,例如 New-CimSessionGet-CimSession cmdlet 的输出。 默认值为本地计算机上的当前会话。

参数属性

类型:

CimSession[]

默认值:None
支持通配符:False
不显示:False

参数集

SessionSet
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ClassName

指定要对其执行操作的 CIM 类的名称。 可以使用 Tab 补全浏览类列表,因为 PowerShell 从本地 WMI 服务器获取类列表,以提供类名列表。

参数属性

类型:String
默认值:None
支持通配符:True
不显示:False

参数集

(All)
Position:0
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ComputerName

指定要在其中运行 CIM 操作的计算机。 可以指定 NetBIOS 名称或 IP 地址的完全限定域名(FQDN)。

如果指定此参数,cmdlet 将使用 WsMan 协议创建到指定计算机的临时会话。

如果未指定此参数,cmdlet 将使用组件对象模型(COM)在本地计算机上执行该操作。

如果在同一台计算机上执行了多个操作,则使用 CIM 会话可提供更好的性能。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False
别名:中国区, 服务器名称

参数集

ComputerSet
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-MethodName

查找具有与此名称匹配的方法的类。 可以将通配符与此参数一起使用。

参数属性

类型:String
默认值:None
支持通配符:True
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Namespace

指定 CIM 操作的命名空间。 默认命名空间 根/CIMV2。 可以使用 Tab 完成浏览命名空间列表,因为 PowerShell 从本地 WMI 服务器获取命名空间列表以提供命名空间列表。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-OperationTimeoutSec

指定 cmdlet 等待计算机响应的时间量。 默认情况下,此参数的值为 0,这意味着 cmdlet 使用服务器的默认超时值。

如果 OperationTimeoutSec 参数设置为小于可靠连接重试超时 3 分钟的值,则超过 OperationTimeoutSec 参数的值的网络故障不可恢复,因为服务器上的操作在客户端重新连接之前超时。

参数属性

类型:UInt32
默认值:None
支持通配符:False
不显示:False
别名:OT

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-PropertyName

查找具有与此名称匹配的属性的类。 可以将通配符与此参数一起使用。

参数属性

类型:String
默认值:None
支持通配符:True
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-QualifierName

按类级别限定符名称筛选类。 可以将通配符与此参数一起使用。

参数属性

类型:String
默认值:None
支持通配符:True
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

None

不能用管道将对象传送到此 cmdlet。

输出

CimClass

此 cmdlet 返回 CIM 类对象。

备注

PowerShell 包含以下与 Get-CimClass相关的别名:

  • 窗户:
    • gcls

此 cmdlet 仅在 Windows 平台上可用。