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 平台上可用。

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

示例

示例 1：获取所有类定义

此示例获取命名空间 root/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：从特定命名空间获取类定义

此示例从指定的命名空间 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中，然后使用 cmdlet 获取类Get-CimClass。

参数

-Amended

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

此参数已添加到 PowerShell 7.3 中。

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

-CimSession

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

Type:	CimSession[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ClassName

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

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

-ComputerName

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

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

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

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

Type:	String[]
Aliases:	CN, ServerName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MethodName

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

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

-Namespace

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

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

-OperationTimeoutSec

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

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

Type:	UInt32
Aliases:	OT
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PropertyName

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

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

-QualifierName

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

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

输入

None

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

输出

CimClass

此 cmdlet 返回 CIM 类对象。

备注

PowerShell 包含以下别名 Get-CimClass：

Windows:
- gcls

此 cmdlet 仅在 Windows 平台上可用。

New-CimSession

通过