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

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

這組命令會建立具有多部計算機的會話，並使用 New-CimSession Cmdlet 將它儲存到變數 $s，然後使用 Get-CimClass Cmdlet 取得類別。

參數

-Amended

表示從 CIM 查詢傳回的物件應該包含已修改的資訊。 一般而言，修改的資訊是可當地語系化的資訊，例如附加至 CIM 物件的物件和屬性描述。 這適用於將數值轉譯為人類可讀取的值。

此參數已在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 類別的名稱。 您可以使用索引標籤自動完成來瀏覽類別清單，因為 PowerShell 會從本機 WMI 伺服器取得類別清單，以提供類別名稱清單。

類型:	String
Position:	0
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	True

-ComputerName

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

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

• 窗戶：
  • gcls

此 Cmdlet 僅適用於 Windows 平臺。

相關連結

• New-CimSession