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 指令檔會取得特定命名空間中的 CIM 類別清單。 若未提供類別名稱，則 cmdlet 會回傳命名空間中的所有類別。 與 CIM 實例不同，CIM 類別不包含取用 CIM 會話或電腦名稱。
範例
範例 1：取得所有類別定義
這個範例會取得所有在 命名空間根/CIMV2 下的類別定義。
Get-CimClass
範例二：取得有特定名稱的職業
這個範例會取得包含 Disk 這個詞的類別名稱。
Get-CimClass -ClassName *Disk*
範例 3：取得具有特定方法名稱的類別
這個範例取得以 Win32 開頭，且方法名稱以 Term 開頭的類別。
Get-CimClass -ClassName Win32* -MethodName Term*
範例 4：取得具有特定屬性名稱的類別
這個範例取得以 Win32 開頭且擁有 Handle 屬性的類別。
Get-CimClass -ClassName Win32* -PropertyName Handle
範例五：取得有特定限定詞名稱的職業
這個範例取得以 Win32 開頭、名稱中包含 Disk 一詞，並帶有指定限定符 Association（關聯）的類別。
Get-CimClass -ClassName Win32*Disk* -QualifierName Association
範例 6：從特定命名空間取得類別定義
此範例從指定的命名空間根源/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中新增。
參數屬性
| 類型: | 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 操作。 你可以指定一個完全限定的網域名稱（FQDN）、NetBIOS 名稱或 IP 位址。
如果您指定此參數，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 操作的命名空間。 預設命名空間 根/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 平臺。
