Get-CimClass

模組:

CimCmdlets

取得特定命名空間中的 CIM 類別清單。

Syntax

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>]

Description

此 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 一字，並具有指定的限定符關聯。

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

範例 6：從特定命名空間取得類別定義

這個範例會從指定的命名空間根/standardCimv2，取得類別定義，其中包含其名稱中的 Net 一字。

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

範例 7：從遠端伺服器取得類別定義

這個範例會從指定的遠端伺服器 Server01 和 Server02 取得類別定義，其中包含其名稱中的單字磁碟。

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

範例 8：使用 CIM 會話取得類別

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

這組命令會建立具有多部計算機的會話，並使用 Cmdlet 將它儲存到變數$sNew-CimSession中，然後使用 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 類別的名稱。 您可以使用索引標籤自動完成來瀏覽類別清單，因為 PowerShell 會從本機 WMI 伺服器取得類別清單，以提供類別名稱清單。

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

-ComputerName

指定您要執行 CIM 作業的電腦。 您可以指定 NetBIOS 名稱或 IP 位址的完整功能變數名稱（FQDN）。

如果您指定此參數，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。 您可以使用索引標籤自動完成來瀏覽命名空間清單，因為 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