Get-WSManInstance

構文

GetInstance (既定)

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

Enumerate

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

説明

例

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

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

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

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

例 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"

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

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

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

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

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

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

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

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

パラメーター

-ApplicationName

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

<トランスポート>://<サーバー>:<ポート>/<ApplicationName>

例: http://server01:8080/WSMAN

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

パラメーターのプロパティ

パラメーター セット

-Associations

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

パラメーターのプロパティ

パラメーター セット

-Authentication

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

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

パラメーターのプロパティ

パラメーター セット

-BasePropertiesOnly

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

パラメーターのプロパティ

パラメーター セット

-CertificateThumbprint

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

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

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

パラメーターのプロパティ

パラメーター セット

-ComputerName

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

パラメーターのプロパティ

パラメーター セット

-ConnectionURI

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

<トランスポート>://<Server>:<ポート>/<ApplicationName>

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

http://Server01:8080/WSMAN

URI は完全修飾されている必要があります。

パラメーターのプロパティ

パラメーター セット

-Credential

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

パラメーターのプロパティ

パラメーター セット

-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

パラメーターのプロパティ

パラメーター セット

-Enumerate

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

パラメーターのプロパティ

パラメーター セット

-Filter

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

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

"Select * from Win32_Service where State != Running"

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

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

パラメーターのプロパティ

パラメーター セット

-Fragment

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

-Fragment Status

パラメーターのプロパティ

パラメーター セット

-OptionSet

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

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

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

パラメーターのプロパティ

パラメーター セット

-Port

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

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

パラメーターのプロパティ

パラメーター セット

-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

パラメーターのプロパティ

パラメーター セット

-ReturnType

返されるデータの種類を指定します。 このパラメーターに使用できる値は次のとおりです。

• Object
• EPR
• ObjectAndEPR

既定値は Object です。

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

パラメーターのプロパティ

パラメーター セット

-SelectorSet

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

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

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

パラメーターのプロパティ

パラメーター セット

-SessionOption

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

パラメーターのプロパティ

パラメーター セット

-Shallow

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

パラメーターのプロパティ

パラメーター セット

-UseSSL

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

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

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

None

出力

XmlElement

関連リンク

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance (リムーブ-WSマネージメントインスタンス)
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan