Get-WmiObject

參考

模組:: Microsoft.PowerShell.Management

取得 Windows Management Instrumentation （WMI）類別的實例或可用類別的相關信息。

語法

Get-WmiObject
   [-Class] <String>
   [[-Property] <String[]>]
   [-Filter <String>]
   [-Amended]
   [-DirectRead]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [[-Class] <String>]
   [-Recurse]
   [-Amended]
   [-List]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-DirectRead]
   -Query <String>
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Get-WmiObject
   [-Amended]
   [-AsJob]
   [-Impersonation <ImpersonationLevel>]
   [-Authentication <AuthenticationLevel>]
   [-Locale <String>]
   [-EnableAllPrivileges]
   [-Authority <String>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [<CommonParameters>]

Description

從 PowerShell 3.0 開始，此 Cmdlet 已被取代 Get-CimInstance。

Cmdlet Get-WmiObject 會取得 WMI 類別的實例或可用 WMI 類別的相關信息。若要指定遠端計算機，請使用 ComputerName 參數。 如果指定 List 參數，Cmdlet 會取得指定命名空間中可用之 WMI 類別的相關信息。 如果指定 Query 參數，Cmdlet 會執行 WMI 查詢語言（WQL）語句。

Cmdlet Get-WmiObject 不會使用 Windows PowerShell 遠端執行遠端作業。即使您的計算機不符合 Windows PowerShell 遠端處理的需求，或未在 Windows PowerShell 中設定遠端處理，您還是可以使用 Cmdlet 的 ComputerName 參數 Get-WmiObject 。

從 Windows PowerShell 3.0 開始，傳回之物件的 Get-WmiObject __Server 屬性具有 PSComputerName 別名。這可讓您更輕鬆地在輸出和報表中包含來源計算機名稱。

範例

範例 1：取得本機計算機上的進程

此範例會取得本機電腦上的進程。

Get-WmiObject -Class Win32_Process

範例 2：取得遠端電腦上的服務

這個範例會取得遠端電腦上的服務。 ComputerName 參數會指定遠端電腦的 IP 位址。根據預設，目前的用戶帳戶必須是遠端電腦上的 Administrators 群組成員。

Get-WmiObject -Class Win32_Service -ComputerName 10.1.4.62

範例 3：取得本機計算機根或預設命名空間中的 WMI 類別

這個範例會取得本機計算機根或預設命名空間中的 WMI 類別。

Get-WmiObject -Namespace "root/default" -List

範例 4：在多部計算機上取得具名服務

這個範例會取得 ComputerName 參數值所指定電腦上的 WinRM 服務。

Get-WmiObject -Query "select * from win32_service where name='WinRM'" -ComputerName Server01, Server02 |
  Format-List -Property PSComputerName, Name, ExitCode, Name, ProcessID, StartMode, State, Status

PSComputerName : SERVER01
Name           : WinRM
ExitCode       : 0
Name           : WinRM
ProcessID      : 844
StartMode      : Auto
State          : Running
Status         : OK

PSComputerName : SERVER02
Name           : WinRM
ExitCode       : 0
Name           : WinRM
ProcessID      : 932
StartMode      : Auto
State          : Running
Status         : OK

管線運算符（|）會將輸出傳送至 Format-List Cmdlet，此 Cmdlet 會將 PSComputerName 屬性新增至預設輸出。 PSComputerName 是傳回物件的Get-WmiObject__Server屬性別名。此別名是在 PowerShell 3.0 中引進的。

範例 5：停止遠端電腦上的服務

此範例會停止遠端電腦上的WinRM服務。 Get-WmiObject 會取得 Server01 上 WinRM 服務對象的實例。然後，它會在該物件上叫用Win32_Service WMI 類別的 StopService 方法。

(Get-WmiObject -Class Win32_Service -Filter "name='WinRM'" -ComputerName Server01).StopService()

這相當於使用 Stop-Service Cmdlet。

範例 6：取得本機電腦上的 BIOS

此範例會從本機計算機取得 BIOS 資訊。 Cmdlet 的 Format-List Property 參數是用來在清單中顯示傳回之物件的所有屬性。根據預設，只會顯示組態檔中 Types.ps1xml 定義的屬性子集。

Get-WmiObject -Class Win32_Bios | Format-List -Property *

Status                : OK
Name                  : Phoenix ROM BIOS PLUS Version 1.10 A05
Caption               : Phoenix ROM BIOS PLUS Version 1.10 A05
SMBIOSPresent         : True
__GENUS               : 2
__CLASS               : Win32_BIOS
__SUPERCLASS          : CIM_BIOSElement
__DYNASTY             : CIM_ManagedSystemElement
__RELPATH             : Win32_BIOS.Name="Phoenix ROM BIOS PLUS Version 1.10
__PROPERTY_COUNT      : 27
__DERIVATION          : {CIM_BIOSElement, CIM_SoftwareElement, CIM_LogicalElement,
__SERVER              : Server01
__NAMESPACE           : root\cimv2
__PATH                : \\SERVER01\root\cimv2:Win32_BIOS.Name="Phoenix ROM BIOS
BiosCharacteristics   : {7, 9, 10, 11...}
BIOSVersion           : {DELL   - 15, Phoenix ROM BIOS PLUS Version 1.10 A05}
BuildNumber           :
CodeSet               :
CurrentLanguage       : en|US|iso8859-1
Description           : Phoenix ROM BIOS PLUS Version 1.10 A05
IdentificationCode    :
InstallableLanguages  : 1
InstallDate           :
LanguageEdition       :
ListOfLanguages       : {en|US|iso8859-1}
Manufacturer          : Dell Inc.
OtherTargetOS         :
PrimaryBIOS           : True
ReleaseDate           : 20101103000000.000000+000
SerialNumber          : 8VDM9P1
SMBIOSBIOSVersion     : A05
SMBIOSMajorVersion    : 2
SMBIOSMinorVersion    : 6
SoftwareElementID     : Phoenix ROM BIOS PLUS Version 1.10 A05
SoftwareElementState  : 3
TargetOperatingSystem : 0
Version               : DELL   - 15
Scope                 : System.Management.ManagementScope
Path                  : \\SERVER01\root\cimv2:Win32_BIOS.Name="Phoenix ROM BIOS
Options               : System.Management.ObjectGetOptions
ClassPath             : \\JUNE-PC\root\cimv2:Win32_BIOS
Properties            : {BiosCharacteristics, BIOSVersion, BuildNumber, Caption...}
SystemProperties      : {__GENUS, __CLASS, __SUPERCLASS, __DYNASTY...}
Qualifiers            : {dynamic, Locale, provider, UUID}
Site                  :
Container             :

範例 7：取得遠端電腦上的服務

此範例會使用 Cmdlet 的 Get-WmiObject Credential 參數來取得遠端電腦上的服務。 Credential 參數的值是用戶帳戶名稱。使用者會被提示輸入密碼。

Get-WmiObject Win32_Service -Credential FABRIKAM\administrator -ComputerName Fabrikam

注意

以本機計算機為目標時，無法使用認證。

參數

-Amended

取得或設定值，這個值表示從WMI傳回的物件是否應該包含修訂的資訊。一般而言，修改的資訊是可當地語系化的資訊，例如附加至 WMI 物件的物件和屬性描述。

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

-AsJob

以背景工作身分執行命令。使用此參數來執行需要很長的時間才能完成的命令。

當您使用 AsJob 參數時，命令會傳回代表背景工作的物件，然後顯示命令提示字元。您可以在作業完成時繼續在工作階段中工作。如果 Get-WmiObject 與 ComputerName 參數搭配使用，則會在本機電腦上建立作業，而且遠端電腦的結果會自動傳回至本機電腦。若要管理作業，請使用包含名詞的 Job Cmdlet。若要取得作業結果，請使用 Receive-Job Cmdlet。

如需 Windows PowerShell 背景工作的詳細資訊，請參閱 about_Jobs 和 about_Remote_Jobs。

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

-Authentication

指定要與 WMI 連線搭配使用的驗證層級。有效值為：

-1： 未變更
0： 預設值
1：無（未執行驗證。
2：連線（只有在用戶端與應用程式建立關聯性時，才會執行驗證。
3：呼叫（只有在應用程式收到要求時，每個呼叫的開頭才會執行驗證。
4：封包（驗證是在從用戶端接收的所有數據上執行。
5： PacketIntegrity （用戶端與應用程式之間傳輸的所有數據都會經過驗證和驗證。
6： PacketPrivacy （會使用其他驗證層級的屬性，並加密所有數據。

類型:	AuthenticationLevel
接受的值:	Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Authority

指定要用來驗證 WMI 連線的授權單位。您可以指定標準 NTLM 或 Kerberos 驗證。若要使用 NTLM，請將授權單位設定 ntlmdomain:<DomainName>設為，其中 <DomainName> 會識別有效的 NTLM 功能變數名稱。若要使用 Kerberos，請指定 kerberos:<DomainName>\<ServerName>。當您連線到本機計算機時，無法包含授權單位設定。

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

-Class

指定 WMI 類別的名稱。使用此參數時，Cmdlet 會擷取 WMI 類別的實例。

類型:	String
別名:	ClassName
Position:	1
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ComputerName

指定管理作業的目標計算機。輸入完整功能變數名稱（FQDN）、NetBIOS 名稱或IP位址。當遠端電腦位於與本機計算機不同的網域時，需要完整功能變數名稱。

預設是本機電腦。若要指定本機計算機，例如在計算機名稱清單中，請使用 localhost、本機計算機名稱或點（.）。

指定遠端電腦時，您目前的帳戶或您以 Credential 參數指定的帳戶必須具有適當的許可權才能存取資訊。

此參數不依賴使用 WS-Management 的 Windows PowerShell 遠端處理。即使您的電腦未設定為執行 WS-Management 遠端命令，您也可以使用 的 ComputerName 參數 Get-WmiObject 。

類型:	String[]
別名:	Cn
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Credential

指定具有執行此動作許可權的用戶帳戶。預設為目前使用者。輸入使用者名稱，例如 User01、 Domain01\User01或 User@Contoso.com。或者，輸入 PSCredential 物件，例如 Cmdlet 所 Get-Credential 傳回的物件。當您輸入使用者名稱時，系統會提示您輸入密碼。以本機計算機為目標時，無法使用認證。

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

-DirectRead

指定是否針對指定的類別要求直接存取 WMI 提供者，而不考慮其基類或其衍生類別。

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

-EnableAllPrivileges

在命令進行 WMI 呼叫之前，啟用目前使用者的所有許可權。

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

-Filter

指定要 當做篩選使用的 Where 子句。使用 WMI 查詢語言（WQL）的語法。

重要

請勿在 參數的值中包含 Where 關鍵詞。例如，下列命令只會傳回具有 DeviceID 的 c: 邏輯磁碟，以及名稱為『WinRM』的服務，而不使用 Where 關鍵詞。

Get-WmiObject Win32_LogicalDisk -filter "DeviceID = 'c:' "

Get-WmiObject win32_service -filter "name='WinRM'"

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

-Impersonation

指定要使用的模擬層級。

此參數可接受的值為：

0： 預設值。讀取預設模擬層級的本機登錄。預設值通常會設定為 [模擬]。
1：匿名。隱藏呼叫端的認證。
2：識別。允許物件查詢呼叫端的認證。
3：模擬。允許物件使用呼叫端的認證。
4：委派。允許物件許可其他物件使用呼叫端的認證。

類型:	ImpersonationLevel
接受的值:	Default, Anonymous, Identify, Impersonate, Delegate
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-List

取得 WMI 存放庫命名空間中由 Namespace 參數指定之 WMI 類別的名稱。

如果您指定 List 參數，但不是 Namespace 參數， Get-WmiObject 則預設會使用 Root\Cimv2 命名空間。此 Cmdlet 不會使用登錄機碼中的 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WBEM\Scripting Default Namespace 登錄項目來判斷預設命名空間。

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

-Locale

指定 WMI 物件的慣用地區設定。以格式輸入值 MS_<LCID> 。

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

-Namespace

搭配 Class 參數使用時， Namespace 參數會指定指定指定 WMI 類別所在的 WMI 存放庫命名空間。搭配 List 參數使用時，它會指定要從中收集 WMI 類別資訊的命名空間。

類型:	String
別名:	NS
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Property

指定此 Cmdlet 從中取得資訊的 WMI 類別屬性。輸入屬性名稱。

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

-Query

執行指定的 WMI 查詢語言（WQL）語句。此參數不支援事件查詢。

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

-Recurse

搜尋目前命名空間和所有其他命名空間，以尋找 Class 參數所指定的類別名稱。

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

-ThrottleLimit

指定可以同時執行的 WMI 作業數目上限。只有在命令中使用 AsJob 參數時，此參數才有效。

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

輸入

None

您無法使用管線將輸入傳送至 Get-WmiObject。

輸出

PSObject or System.Management.Automation.RemotingJob

當您使用 AsJob 參數時，Cmdlet 會傳回作業物件。否則，傳Get-WmiObject回的對象取決於 Class 參數的值。

備註

Windows PowerShell 包含下列的 Get-WmiObject別名：

gwmi

若要存取遠端電腦上的 WMI 資訊，Cmdlet 必須在遠端電腦上本機系統管理員群組成員的帳戶下執行。或者，可以變更遠端存放庫 WMI 命名空間上的預設存取控制，以授與其他帳戶的訪問許可權。

預設只會顯示每個 WMI 類別的某些屬性。組態檔中 Types.ps1xml 會指定每個 WMI 類別所顯示的屬性集。若要取得 WMI 物件的所有屬性，請使用 Get-Member 或 Format-List Cmdlet。

共用方式為

Get-WmiObject

語法

Description

範例

範例 1：取得本機計算機上的進程

範例 2：取得遠端電腦上的服務

範例 3：取得本機計算機根或預設命名空間中的 WMI 類別

範例 4：在多部計算機上取得具名服務

範例 5：停止遠端電腦上的服務

範例 6：取得本機電腦上的 BIOS

範例 7：取得遠端電腦上的服務

參數

-Amended

-AsJob

-Authentication

-Authority

-Class

-ComputerName

-Credential

-DirectRead

-EnableAllPrivileges

-Filter

-Impersonation

-List

-Locale

-Namespace

-Property

-Query

-Recurse

-ThrottleLimit

輸入

輸出

備註

其他資源

共用方式為

Get-WmiObject

語法

Description

範例

範例 1：取得本機計算機上的進程

範例 2：取得遠端電腦上的服務

範例 3：取得本機計算機根或預設命名空間中的 WMI 類別

範例 4：在多部計算機上取得具名服務

範例 5：停止遠端電腦上的服務

範例 6：取得本機電腦上的 BIOS

範例 7：取得遠端電腦上的服務

參數

-Amended

-AsJob

-Authentication

-Authority

-Class

-ComputerName

-Credential

-DirectRead

-EnableAllPrivileges

-Filter

-Impersonation

-List

-Locale

-Namespace

-Property

-Query

-Recurse

-ThrottleLimit

輸入

輸出

備註

相關連結

其他資源