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