Get-WmiObject

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
    -Query <String>
    [-Amended]
    [-DirectRead]
    [-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>]

从 PowerShell 3.0 开始，此 cmdlet 已被 Get-CimInstance取代。

Get-WmiObject cmdlet 获取 WMI 类的实例或有关可用 WMI 类的信息。 若要指定远程计算机，请使用 ComputerName 参数。 如果指定了 List 参数，则 cmdlet 将获取有关指定命名空间中可用的 WMI 类的信息。 如果指定了 Query 参数，则 cmdlet 将运行 WMI 查询语言 （WQL） 语句。

Get-WmiObject cmdlet 不使用 Windows PowerShell 远程处理来执行远程作。 即使计算机不符合 Windows PowerShell 远程处理的要求或未配置为在 Windows PowerShell 中远程处理，也可以使用 cmdlet 的 Get-WmiObject 参数。

从 Windows PowerShell 3.0 开始， 返回对象的 Get-WmiObject 属性具有 PSComputerName 别名。 这样，在输出和报表中可以更轻松地包含源计算机名称。

此示例获取本地计算机上的进程。

Get-WmiObject -Class Win32_Process

此示例获取远程计算机上的服务。 ComputerName 参数指定远程计算机的 IP 地址。 默认情况下，当前用户帐户必须是远程计算机上的 管理员 组的成员。

Get-WmiObject -Class Win32_Service -ComputerName 10.1.4.62

此示例获取本地计算机的根命名空间或默认命名空间中的 WMI 类。

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

此示例获取由 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 属性的别名。 PowerShell 3.0 中引入了此别名。

此示例停止远程计算机上的 WinRM 服务。 Get-WmiObject 获取 Server01 上的 WinRM 服务对象的实例。 然后，它会在该对象上调用 Win32_Service WMI 类的 StopService 方法。

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

这相当于使用 Stop-Service cmdlet。

此示例从本地计算机获取 BIOS 信息。 cmdlet 的 Format-List 参数用于显示列表中返回的对象的所有属性。 默认情况下，仅显示 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             :

此示例使用 cmdlet 的 Get-WmiObject 参数获取远程计算机上的服务。 Credential 参数的值是用户帐户名。 系统会提示用户输入密码。

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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能通过管道将输入传递给 Get-WmiObject。

使用 AsJob 参数时，cmdlet 将返回作业对象。 否则，Get-WmiObject 返回的对象取决于 Class 参数的值。

Windows PowerShell 包含以下 Get-WmiObject别名：

• gwmi

若要访问远程计算机上的 WMI 信息，该 cmdlet 必须在远程计算机上的本地管理员组成员的帐户下运行。 或者，可以更改远程存储库 WMI 命名空间上的默认访问控制，以授予对其他帐户的访问权限。

默认情况下，仅显示每个 WMI 类的一些属性。 Types.ps1xml 配置文件中指定了为每个 WMI 类显示的属性集。 若要获取 WMI 对象的所有属性，请使用 Get-Member 或 Format-List cmdlet。