Test-WSMan

[アーティクル]
10/30/2009

ローカルまたはリモートコンピューター上の WinRM サービスが実行中かどうかをテストします。

構文

Test-WSMan [[-ComputerName] <string>] [-Authentication <Authentication>] [-Credential <PSCredential>] [<CommonParameters>]

説明

Test-WSMan コマンドレットは、WinRM サービスがローカルコンピューターで実行されているかリモートコンピューターで実行されているかを確認する識別要求を送信します。テスト対象のコンピューターでサービスが実行されている場合は、テストするサービスの WS-Management 識別スキーマ、プロトコルバージョン、製品の製造元、製品のバージョンなどが表示されます。

パラメーター

-Authentication <Authentication>

サーバーで使用される認証メカニズムを指定します。設定可能な値は、次のとおりです。

- Basic: Basic は、ユーザー名およびパスワードがクリアテキストでサーバーまたはプロキシに送信されるスキームです。

- Default: WS-Management プロトコルによって実装された認証方法を使用します。

- Digest: Digest は、サーバーで指定されたデータ文字列をチャレンジで使用するチャレンジ/レスポンススキームです。

- Kerberos: クライアントコンピューターとサーバーは、Kerberos 証明書を使用して手動で認証されます。

- Negotiate: Negotiate は、認証で使用するスキームを特定するために、サーバーまたはプロキシとネゴシエートするチャレンジ/レスポンススキームです。たとえば、このパラメーター値を指定すると、Kerberos プロトコルと NTLM のどちらが使用されるかを特定するネゴシエーションを行うことができます。

- CredSSP: 資格情報のセキュリティサービスプロバイダー (CredSSP) 認証を使用します。この認証では、ユーザーが資格情報を委任できます。このオプションは、1 台のリモートコンピューターで実行していても、データを他のリモートコンピューターから収集したり、追加のコマンドを他のリモートコンピューターで実行したりするコマンド用に設計されています。

注意: CredSSP により、ユーザーの資格情報がローカルコンピューターからリモートコンピューターに委任されます。これを実行すると、リモート操作のセキュリティリスクが増します。リモートコンピューターのセキュリティが低下している場合に、そのリモートコンピューターに資格情報を渡すと、それを使用してネットワークセッションを制御できます。

重要: 認証パラメーターを指定しないと、Test-WSMan 要求は認証を使用せずにリモートマシンに匿名で送信されます。Test-WSMan 要求を匿名で送信した場合、オペレーティングシステムのバージョンに固有の情報が返されません。代わりに、Test-WSMan はオペレーティングシステムのバージョンとサービスパックレベルにヌル値を表示します (OS: 0.0.0 SP: 0.0)。

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-ComputerName <string>

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

必須	false
位置	1
既定値	localhost
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Credential <PSCredential>

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

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。詳細については、次を参照してください: about_Commonparameters.

入力と出力

入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。

入力

なし

このコマンドレットは入力を受け取りません。

出力

なし

このコマンドレットは出力オブジェクトを生成しません。

注

既定では、Test-WSMan コマンドレットは認証を使用せずに WinRM サービスにクエリし、オペレーティングシステムのバージョンに固有の情報を返しません。代わりに、オペレーティングシステムのバージョンとサービスパックレベルにヌル値を表示します (OS: 0.0.0 SP: 0.0)。

例 1

C:\PS>test-wsman

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 0.0.0 SP: 0.0 Stack: 2.0

説明
-----------
このコマンドは、WinRM サービスがローカル コンピューターで実行されているかリモート コンピューターで実行されているかを判別します。

例 2

C:\PS>test-wsman -computername server01

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 0.0.0 SP: 0.0 Stack: 2.0

説明
-----------
このコマンドは、WinRM サービスが server01 という名前のコンピューターで実行されているかどうかを判別します。

例 3

C:\PS>test-wsman -authentication default

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.0.6001 SP: 1.0 Stack: 2.0

説明
-----------
このコマンドは認証パラメーターを使用して、ローカル コンピューターで WS-Management (WinRM) サービスが実行されているかどうかをテストします。

認証パラメーターを使用すると、Test-WSMan コマンドレットはオペレーティング システムのバージョンを返すことができます。

例 4

C:\PS>test-wsman -computername server01 -authentication default

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.1.7021 SP: 0.0 Stack: 2.0

説明
-----------
このコマンドは認証パラメーターを使用して、server01 という名前のコンピューターで WS-Management (WinRM) サービスが実行されているかどうかをテストします。

認証パラメーターを使用すると、Test-WSMan コマンドレットはオペレーティング システムのバージョンを返すことができます。

次の方法で共有