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
   [-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>]

説明

PowerShell 3.0 以降、このコマンドレットは Get-CimInstanceに置き換わりました。

Get-WmiObject コマンドレットは、WMI クラスのインスタンスまたは使用可能な WMI クラスに関する情報を取得します。 リモート コンピューターを指定するには、 ComputerName パラメーターを使用します。 List パラメーターが指定されている場合、コマンドレットは、指定した名前空間で使用可能な WMI クラスに関する情報を取得します。 Query パラメーターを指定すると、コマンドレットは WMI クエリ言語 (WQL) ステートメントを実行します。

Get-WmiObject コマンドレットは、リモート操作を実行するために Windows PowerShell リモート処理を使用しません。 コンピューターが Windows PowerShell リモート処理の要件を満たしていない場合や、Windows PowerShell でリモート処理用に構成されていない場合でも、Get-WmiObject コマンドレットの ComputerName パラメーターを使用できます。

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 コマンドレットに出力を送信し、既定の出力に 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 コマンドレットの使用と同じです。

例 6: ローカル コンピューターで BIOS を取得する

この例では、ローカル コンピューターから BIOS 情報を取得します。 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: リモート コンピューターでサービスを取得する

この例では、Get-WmiObject コマンドレットの Credential パラメーターを使用して、リモート コンピューター上のサービスを取得します。 Credential パラメーターの値は、ユーザー アカウント名です。 ユーザーにパスワードの入力を求めるメッセージが表示されます。

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

パラメーター

-Amended

-AsJob

-Authentication

-Authority

-Class

-ComputerName

-Credential

-DirectRead

-EnableAllPrivileges

-Filter

-Impersonation

-List

-Locale

-Namespace

-Property

-Query

-Recurse

-ThrottleLimit

入力

None

Get-WmiObjectに入力をパイプすることはできません。

出力

PSObject or System.Management.Automation.RemotingJob

AsJob パラメーターを使用すると、コマンドレットはジョブ オブジェクトを返します。 それ以外の場合、 Get-WmiObject が返すオブジェクトは、 Class パラメーターの値によって異なります。

メモ

Windows PowerShell には、 Get-WmiObjectの次のエイリアスが含まれています。

• gwmi

リモート コンピューターの WMI 情報にアクセスするには、リモート コンピューターのローカル管理者グループに属しているアカウントでこのコマンドレットを実行する必要があります。 また、リモート リポジトリの WMI 名前空間に対する既定のアクセス制御を変更して、他のアカウントにアクセス権を許可する方法もあります。

既定では、各 WMI クラスの一部のプロパティのみが表示されます。 各 WMI クラスに表示されるプロパティのセットは、 Types.ps1xml 構成ファイルで指定されます。 WMI オブジェクトのすべてのプロパティを取得するには、 Get-Member または Format-List コマンドレットを使用します。

関連リンク

• Invoke-WmiMethod
• Remove-WmiObject
• Set-WmiInstance
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• Remove-WSManInstance