Test-WSMan

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

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

例: http://server01:8080/WSMAN

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

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

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

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

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

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

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

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

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

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

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

トランスポートとして HTTPS を使用する場合、ComputerName パラメーターの値は、サーバーの証明書の共通名 (CN) と一致する必要があります。

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

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