次の方法で共有


Test-WSMan

ローカルまたはリモート コンピューター上の 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 コマンドレットはオペレーティング システムのバージョンを返すことができます。





関連項目

概念

Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig