Get-WSManInstance

リファレンス

モジュール:: Microsoft.WSMan.Management

リソース URI で指定されたリソースインスタンスの管理情報を表示します。

構文

Get-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Get-WSManInstance
   [-ApplicationName <String>]
   [-BasePropertiesOnly]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Enumerate]
   [-Filter <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-Associations]
   [-ResourceURI] <Uri>
   [-ReturnType <String>]
   [-SessionOption <SessionOption>]
   [-Shallow]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

説明

このコマンドレットは Get-WSManInstance 、リソース Uniform Resource Identifier (URI) で指定された管理リソースのインスタンスを取得します。取得される情報には、オブジェクトまたは単純な値である複雑な XML 情報セットを指定できます。このコマンドレットは、標準の Web Services for Management (WS-Management) Get コマンドと同等です。

このコマンドレットは、WS-Management の接続/トランスポート層を使用して、情報を取得します。

例

例 1: WMI からすべての情報を取得する

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"

このコマンドは、Windows Management Instrumentation (WMI) がリモートサーバー 01 コンピューター上の WinRM サービスに関して公開するすべての情報を返します。

例 2: スプーラーサービスの状態を取得する

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"

このコマンドは、リモートサーバー 01 コンピューター上の スプーラー サービスの状態のみを返します。

例 3: すべてのサービスのエンドポイント参照を取得する

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR

このコマンドは、ローカルコンピューター上のすべてのサービスに対応するエンドポイント参照を返します。

例 4: 指定した条件を満たすサービスを取得する

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"

このコマンドは、リモート Server01 コンピューターで次の条件を満たすすべてのサービスを一覧表示します。

サービスのスタートアップの種類は [自動] です。
サービスが停止しています。

例 5: ローカルコンピューターの条件に一致するリスナー構成を取得する

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}

このコマンドは、ローカルコンピューター上の、セレクターセットの条件と一致する WS-Management リスナーの構成を一覧表示します。

例 6: リモートコンピューター上の条件に一致するリスナー構成を取得する

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"

このコマンドは、server01 リモートコンピューター上の、セレクターセットの条件と一致する WS-Management リスナーの構成を一覧表示します。

例 7: 指定したインスタンスに関連する関連インスタンスを取得する

Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

このコマンドは、指定されたインスタンス (winrm) に関連付けられているインスタンスを取得します。

次の例に示すように、フィルターを二重引用符で囲む必要があります。

例 8: 指定したインスタンスに関連する関連付けインスタンスを取得する

Get-WSManInstance -Enumerate -Dialect Association -Associations -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

このコマンドは、指定されたインスタンス (winrm) の関連付けインスタンスを取得します。方言の値は関連付けであり、Associations パラメーターが使用されるため、このコマンドは関連付けられたインスタンスではなく、関連付けインスタンスを返します。

次の例に示すように、フィルターを二重引用符で囲む必要があります。

パラメーター

-ApplicationName

接続のアプリケーション名を指定します。 ApplicationName パラメーターの既定値は WSMAN です。リモートエンドポイントの完全な識別子は、次の形式です。

例: http://server01:8080/WSMAN

セッションをホストするインターネットインフォメーションサービス (IIS) は、このエンドポイントで、指定されたアプリケーションに要求を転送します。 WSMAN のこの既定の設定は、ほとんどの用途に適しています。このパラメーターは、多くのコンピューターが PowerShell を実行している 1 台のコンピューターへのリモート接続を確立する場合に使用するように設計されています。この場合、IIS は効率のために WS-Management をホストします。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Associations

このコマンドレットが関連付けられたインスタンスではなく、関連付けインスタンスを取得することを示します。このパラメーターは、言語パラメーターの値が Association の場合にのみ使用できます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

サーバーで使用される認証メカニズムを指定します。このパラメーターの有効値は、次のとおりです。

Basic - Basic は、ユーザー名とパスワードがクリアテキストでサーバーまたはプロキシに送信されるスキームです。
Default - WS-Management プロトコルによって実装された認証方法を使用します。これが既定です。
Digest - Digest は、チャレンジにサーバー指定のデータ文字列を使用するチャレンジ応答スキームです。
Kerberos - クライアントコンピューターとサーバーは、Kerberos 証明書を使用して相互に認証します。
Negotiate - Negotiate は、認証に使用するスキームを決定するためにサーバーまたはプロキシとネゴシエートするチャレンジ応答スキームです。たとえば、このパラメーター値を使用すると、ネゴシエーションで Kerberos プロトコルと NTLM のどちらを使用するかを判断できます。
CredSSP - 資格情報セキュリティサポートプロバイダー (CredSSP) 認証を使用します。これにより、ユーザーは資格情報を委任できます。このオプションは、1 台のリモートコンピューターで実行するが、他のリモートコンピューターからデータを収集するコマンドや、他のリモートコンピューターで追加のコマンドを実行するコマンドを対象としています。

注意

CredSSP は、ローカルコンピューターからリモートコンピューターにユーザーの資格情報を委任します。そのため、リモート操作のセキュリティリスクが高まります。リモートコンピューターのセキュリティが低下している場合は、そのリモートコンピューターに渡された資格情報を使用してネットワークセッションが制御される場合があります。

Type:	AuthenticationMechanism
Aliases:	auth, am
Accepted values:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BasePropertiesOnly

このコマンドレットは、ResourceURI パラメーターで指定された基底クラスの一部であるプロパティのみを列挙することを示します。このパラメーターは、Shallow パラメーターが指定されている場合は無効です。

Type:	SwitchParameter
Aliases:	UBPO, Base
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

この処理を実行するアクセス許可を持つユーザーアカウントのデジタル公開キー証明書 (X509) を指定します。証明書の拇印を入力します。

証明書は、クライアント証明書ベースの認証で使用されます。これらの証明書は、ローカルユーザーアカウントにしかマップできません。ドメインアカウントでは機能しません。

証明書の拇印を取得するには、PowerShell 証明書: ドライブの or Get-ChildItem コマンドを使用Get-Itemします。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

管理操作を実行する対象のコンピューターを指定します。値には、完全修飾ドメイン名、NetBIOS 名、または IP アドレスを指定できます。ローカルコンピューター名を使用するか、localhost を使用するか、ドット (.) を使用してローカルコンピューターを指定します。ローカルコンピューターは、既定値です。リモートコンピューターがユーザーとは異なるドメインにある場合は、完全修飾ドメイン名を使用する必要があります。パイプを使用して、このパラメーターの値をコマンドレットに渡すことができます。

Type:	String
Aliases:	CN
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionURI

接続エンドポイントを指定します。この文字列の形式は次のとおりです。

次の文字列は、このパラメーターに対して正しく書式設定された値です。

http://Server01:8080/WSMAN

URI は完全修飾名にする必要があります。

Type:	Uri
Aliases:	CURI, CU
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

この処理を実行するアクセス許可を持つユーザーアカウントを指定します。既定値は現在のユーザーです。 User01、Do、メイン01\User01、など、ユーザー名を入力しますUser@Domain.com。または、コマンドレットによって返される PSCredential オブジェクトなど、PSCredential オブジェクトをGet-Credential入力します。ユーザー名を入力すると、このコマンドレットによってパスワードの入力が求められます。

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Dialect

フィルター述語で使用する言語を指定します。リモートサービスでサポートされている任意の言語を指定できます。言語の URI には、次のエイリアスを使用できます。

WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
セレクター- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
協会- http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enumerate

このコマンドレットによって、管理リソースのすべてのインスタンスが返されることを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

列挙体のフィルター式を指定します。このパラメーターを指定する場合は、言語も指定する必要があります。

このパラメーターの有効な値は、言語で 指定されている方言によって異なります。たとえば、言語が WQL の場合、Filter パラメーターには文字列が含まれている必要があり、文字列には次のクエリのような有効な WQL クエリが含まれている必要があります。

"Select * from Win32_Service where State != Running"

方言が関連付けである場合、フィルターには文字列が含まれている必要があり、文字列には次のフィルターなどの有効なフィルターが含まれている必要があります。

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Fragment

指定された操作で更新または取得するインスタンス内のセクションを指定します。たとえば、スプーラーサービスの状態を取得するには、次のように指定します。

-Fragment Status

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OptionSet

要求の性質を変更または調整するサービスへのスイッチのセットを指定します。これらは、サービス固有であるため、コマンドラインシェルで使用されるスイッチに似ています。任意の数のオプションを指定できます。

次の例では、a、b、および c パラメーターに値 1、2、および 3 を渡す構文を示します。

-OptionSet @{a=1;b=2;c=3}

Type:	Hashtable
Aliases:	OS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

クライアントが WinRM サービスに接続するときに使用するポートを指定します。トランスポートが HTTP の場合、既定のポートは 80 です。トランスポートが HTTPS の場合、既定のポートは 443 です。

トランスポートとして HTTPS を使用する場合、ComputerName パラメーターの値はサーバーの証明書共通名 (CN) と一致する必要があります。ただし、SessionOption パラメーターの一部として SkipCNCheck パラメーターが指定されている場合、サーバーの証明書の共通名は、サーバーのホスト名と一致する必要はありません。 SkipCNCheck パラメーターは、信頼できるコンピューターにのみ使用する必要があります。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceURI

リソースクラスまたはインスタンスの URI を指定します。 URI は、コンピューター上のディスクやプロセスなどの特定の種類のリソースを識別します。

URI は、リソースのプレフィックスとパスで構成されます。次に例を示します。

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Type:	Uri
Aliases:	RURI
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReturnType

返されるデータの型を指定します。このパラメーターの有効値は、次のとおりです。

Object
EPR
ObjectAndEPR

既定値は Object です。

このパラメーターを指定 Object するか、指定しない場合、このコマンドレットはオブジェクトのみを返します。エンドポイント参照 (EPR) を指定すると、このコマンドレットはオブジェクトのエンドポイント参照のみを返します。エンドポイント参照には、インスタンスのリソース URI とセレクターに関する情報が含まれています。指定 ObjectAndEPRした場合、このコマンドレットはオブジェクトとそれに関連付けられているエンドポイント参照の両方を返します。

Type:	String
Aliases:	RT
Accepted values:	object, epr, objectandepr
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

特定の管理リソースインスタンスの選択に使用する値のペアのセットを指定します。 SelectorSet パラメーターは、リソースの複数のインスタンスが存在する場合に使用されます。 SelectorSet パラメーターの値はハッシュテーブルである必要があります。

次の例では、このパラメーターの値を入力する方法を示します。

-SelectorSet @{Name="WinRM";ID="yyy"}

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionOption

WS-Management セッションの拡張オプションを指定します。 New-WSManSessionOption コマンドレットを使用して作成する SessionOption オブジェクトを入力します。使用できるオプションの詳細については、「.」と入力します Get-Help New-WSManSessionOption。

Type:	SessionOption
Aliases:	SO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Shallow

このコマンドレットは、リソース URI で指定された基底クラスのインスタンスのみを返すように指定します。このパラメーターを指定しない場合、このコマンドレットは URI とそのすべての派生クラスで指定された基底クラスのインスタンスを返します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

リモートコンピューターへの接続を確立するために Secure Sockets Layer (SSL) プロトコルを使用することを指定します。既定では、SSL は使用されません。

WS-Management は、ネットワークを介して転送されるすべての Windows PowerShell コンテンツを暗号化します。 UseSSL パラメーターを使用すると、HTTP ではなく HTTPS の追加の保護を指定できます。接続に使用されているポートで SSL を使用できず、このパラメーターを指定すると、コマンドは失敗します。

Type:	SwitchParameter
Aliases:	SSL
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

XmlElement

このコマンドレットは XMLElement オブジェクトを返します。

Get-WSManInstance

構文

説明

例

例 1: WMI からすべての情報を取得する

例 2: スプーラーサービスの状態を取得する

例 3: すべてのサービスのエンドポイント参照を取得する

例 4: 指定した条件を満たすサービスを取得する

例 5: ローカルコンピューターの条件に一致するリスナー構成を取得する

例 6: リモートコンピューター上の条件に一致するリスナー構成を取得する

例 7: 指定したインスタンスに関連する関連インスタンスを取得する

例 8: 指定したインスタンスに関連する関連付けインスタンスを取得する

パラメーター

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

入力

出力

フィードバック

その他のリソース

Get-WSManInstance

構文

説明

例

例 1: WMI からすべての情報を取得する

例 2: スプーラー サービスの状態を取得する

例 3: すべてのサービスのエンドポイント参照を取得する

例 4: 指定した条件を満たすサービスを取得する

例 5: ローカル コンピューターの条件に一致するリスナー構成を取得する

例 6: リモート コンピューター上の条件に一致するリスナー構成を取得する

例 7: 指定したインスタンスに関連する関連インスタンスを取得する

例 8: 指定したインスタンスに関連する関連付けインスタンスを取得する

パラメーター

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

入力

出力

関連リンク

フィードバック

その他のリソース

例 2: スプーラーサービスの状態を取得する

例 5: ローカルコンピューターの条件に一致するリスナー構成を取得する

例 6: リモートコンピューター上の条件に一致するリスナー構成を取得する