Get-CimClass

模块:

CimCmdlets

获取特定命名空间中的 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：从远程服务器获取类定义

本示例从指定的远程服务器 Server01 和 Server02 获取名称中包含单词 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-CimSession 或 Get-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 平台上可用。

相关链接

• New-CimSession