Get-CimClass

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

语法

Get-CimClass
   [[-ClassName] <string>]
   [[-Namespace] <string>]
   [-Amended]
   [-OperationTimeoutSec <uint>]
   [-ComputerName <string[]>]
   [-MethodName <string>]
   [-PropertyName <string>]
   [-QualifierName <string>]
   [<CommonParameters>]
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:获取所有类定义

此示例获取命名空间 root/cimv2 下的所有类定义。

Get-CimClass

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

本示例获取名称中包含单词 disk 的类。

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:从特定命名空间获取类定义

本示例从指定的命名空间 root/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

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

参数

-Amended

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

此参数已在 PowerShell 7.3 中添加。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CimSession

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

类型:CimSession[]
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ClassName

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

类型:String
Position:0
默认值:None
必需:False
接受管道输入:True
接受通配符:True

-ComputerName

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

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

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

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

类型:String[]
别名:CN, ServerName
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-MethodName

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:True

-Namespace

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

类型:String
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-OperationTimeoutSec

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

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

类型:UInt32
别名:OT
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PropertyName

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:True

-QualifierName

按类级别限定符名称筛选类。 可以在此参数中使用通配符。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:True

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

CimClass

此 cmdlet 返回 CIM 类对象。

备注

PowerShell 包含以下 Get-CimClass 别名:

  • Windows:
    • gcls

此 cmdlet 仅在 Windows 平台上可用。