ローカルまたはリモート コンピューター上の 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 : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://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 : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://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 : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://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 : https://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd ProtocolVersion : https://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 コマンドレットはオペレーティング システムのバージョンを返すことができます。
関連項目