共用方式為


Get-WmiObject

取得 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_Jobsabout_Remote_Jobs

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

-Authentication

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

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

指定具有執行此動作許可權的用戶帳戶。 預設為目前使用者。 輸入使用者名稱,例如 User01Domain01\User01User@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 關鍵詞。 例如,下列命令只會傳回具有 DeviceIDc: 邏輯磁碟,以及名稱為 『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-MemberFormat-List Cmdlet。