Set-WSManInstance

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

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

例えば次が挙げられます。

http://server01:8080/WSMAN

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

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

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

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

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

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

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

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

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

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

次の文字列は、このパラメーターに適切に書式設定された値です。

http://Server01:8080/WSMAN

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

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

フィルター述語で使用する方言を指定します。 リモート サービスでサポートされている任意の方言を指定できます。 言語 URI には、次のエイリアスを使用できます。

• WQLの https://schemas.microsoft.com/wbem/wsman/1/WQL
• セレクタ： https://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• 協会： http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

管理リソースの更新に使用するファイルのパスを指定します。 管理リソースを指定するには、ResourceURI パラメーターと SelectorSet パラメーターを使用します。 たとえば、次のコマンドでは FilePath パラメーターを使用します。

Invoke-WSManAction -action StopService -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default

このコマンドは、ファイルからの入力を使用して、スプーラー サービスの StopService メソッドを呼び出します。 ファイル Input.xmlには、次の内容が含まれています。

<p:StopService_INPUT xmlns:p="https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

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

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

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

-オプションセット @{a=1;b=2;c=3}

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

リソース クラスまたはインスタンスの URI (Uniform Resource Identifier) を格納します。 URI は、コンピューター上のディスクやプロセスなどの特定の種類のリソースを識別するために使用されます。

URI は、プレフィックスとリソースへのパスで構成されます。 例えば次が挙げられます。

https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

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

-SelectorSet @{名前="WinRM";ID="yyy"}

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

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

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

管理リソースの変更に役立つハッシュ テーブルを指定します。 ResourceURI パラメーターと SelectorSet パラメーターを使用して、管理リソースを指定します。 ValueSet パラメーターの値はハッシュ テーブルである必要があります。