Get-WmiObject 帮助信息

如下说明是翻译PowerShell中: help Get-WmiObject 产生的帮助信息.

译者: Edengundam(马涛)

 

Get-WmiObject

 

大纲

取得WMI类的实例或者取得可使用类的信息.

 

语法

Get-WmiObject [-class] <string> [[-property] <string[]>] [-namespace <string>] [-computerName <string[]>] [-filter <string>] [-credential <PSCredential>] [<CommonParameters>]

 

Get-WmiObject [-namespace <string>] [-computerName <string[]>] [-credential <PSCredential>] [-list] [<CommonParameters>]

 

Get-WmiObject -query <string> [-namespace <string>] [-computerName <string[]>] [-credential <PSCredential>] [<CommonParameters>]

 

详细描述

取得WMI类的实例或者取得可使用类的信息. 参数ComputerName用来指向远程的计算机. 如果参数List parameter被指定, 此命令取得指定名称空间中可使用的WMI类信息. 如果指定参数Query, 此命令运行WMI查询语言(WQL)语句.

 

参数

 

-class <string>

指定WMI类的名称. 当使用此参数时, 命令取得WMI类的实例.

 

强制参数?	True
参数位置?	1
默认值
允许从管道绑定输入?	False
允许通配符扩展?	False

 

-property <string[]>

指定取得WMI类的属性或属性集.

 

强制参数?	false
参数位置?	2
默认值	*
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-namespace <string>

当使用了参数Class, 此参数用于指定WMI类所位于的WMI存储库名称空间. 当与参数List一起使用时, 它指定了检索WMI类信息的位置.

 

强制参数?	false
参数位置?	named
默认值	Root/cimv2
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-computerName <string[]>

指定此命令将执行的目标计算机. 此命令通过指定计算机上的WMI服务(CIMOM)取得WMI类信息和WMI类的实例. 每台计算机的名称可以是NETBIOS名称, IP地址, 或者一个完全限定的域名. 此外, 你还可以通过使用字符点(.)来指定本地计算机.

 

强制参数?	false
参数位置?	named
默认值	localhost
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-filter <string>

指定一个Where子句作为过滤器使用. 使用WQL语言的语法. 不要在参数值包括Where关键字.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-credential <PSCredential>

使用其他凭证进行资源访问认证. 如果指定了一个之前使用Get-Credential获得的PSCredential对象, 将会直接使用该对象. 如果此处使用用户名, 命令执行时会提示输入该用户密码.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-list <SwitchParameter>

检索并显示Namespace参数指定的WMI存储库名称空间中的WMI类的名称. 此命令不使用注册表项中默认的名称空间(位于注册项HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/WBEM/Scripting中)确定默认名称空间. 如果你指定了参数List, 但是没有提供Namespace参数, 默认使用root/CIMV2名称空间.

 

强制参数?	false
参数位置?	named
默认值	False
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-query <string>

指定要执行的WMI查询语言(WQL)语句. 不支持时间查询(Event queries).

 

强制参数?	true
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

输入类型

None

 

注意

 

更多信息, 输入"Get-Help Get-WmiObject -detailed". 需要技术信息, 输入"Get-Help Get-WmiObject -full".

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

要访问远程计算机的WMI信息, 此命令必须运行在远程计算机上的本地管理员组(local administrators group)中帐号下运行. 或者, 改变远程计算机存储库的WMI名称空间的默认访问权限, 将权限授予其他帐号.

 

默认情况下, WMIl类上的所有属性不会全部显示. 每个WMI类上将会显示的属性集在配置文件types.ps1xml中指定. 帮助主题中包含了一个揭示通过使用Format-List命令来重载显示行为的例子.

 

例1

 

C:/PS>get-wmiobject win32_process

 

此命令显示运行在计算机上的所有进程信息.

 

例2

 

C:/PS>get-wmiobject win32_service -computername 127.0.0.1

 

此命令显示本地计算机上的服务信息. 它是通过指定IP地址127.0.0.1来完成的. 此IP地址可以被替换成您的网络上任何合法的IP地址, 来允许你现实远程计算机上服务信息. 默认情况下, 为了使命令成功执行, 您所运行的命令使用的装好必须是远程计算机上本地管理员组(local administrators group)中的一个成员.

 

例3

 

C:/PS>get-wmiobject -namespace "root/default" -list

 

此命令显示本地计算机root/default名称空间上的WMI类.

 

例4

 

C:/PS>get-wmiobject -query "select * from win32_service where name='alerter'"

 

此命令显示Alerter服务信息.

 

例5

 

C:/PS>(get-wmiobject win32_service -filter "name='alerter'").StopService()

 

此命令停止Alerter服务. 它调用win32_service WMI类上的StopService方法.

 

例6

 

C:/PS>get-wmiobject win32_bios | format-list *

 

T此命令显示BIOS信息. 它不仅仅只显示WMI类定义在配置文件types.ps1中的属性, 而是所有属性.

 

例7

 

C:/PS>get-wmiobject win32_service -credential FABRIKAM/administrator -computer fabrikam

 

此命令显示名为fabrikam的计算机上服务信息. 通过使用Credential参数指定了一个用户名, 此参数将导致弹出一个接收密码的对话框.

 

相关链接

Get-Credential