如下说明是翻译
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