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>]
Description
此 Cmdlet 只能在 Windows 平臺上使用。
Get-CimClass Cmdlet 會擷取特定命名空間中的 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取得類別定義，其中包含名稱中的 磁碟 字。
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-CimSession 或 Get-CimSession Cmdlet 的輸出。 預設為本機電腦上的目前會話。
參數屬性
| 類型: | |
| 預設值: | 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 作業的命名空間。 預設命名空間 root/cimv2。 您可以使用標籤補全功能來瀏覽命名空間清單，因為 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 平臺。