フィードバック

about_WSMan_Provider

  • [アーティクル]

プロバイダー名

WSMan

ドライブ

WSMan:

簡単な説明

Web Services for Management (WS-Management) 構成情報へのアクセスを提供します。

詳しい説明

この情報は、Windows で実行されている PowerShell にのみ適用されます。

PowerShell 用 WSMan プロバイダーを使用すると、ローカル コンピューターまたはリモート コンピューター上のWS-Management構成データを追加、変更、クリア、および削除できます。

WSMan プロバイダーは、構成設定の論理グループに対応するディレクトリ構造を持つ PowerShell WS-Management公開します。 これらのグループ化はコンテナーと呼ばれています。

Windows PowerShell 3.0 から、WSMan プロバイダーは OutputBufferingMode などのセッション構成の新しいプロパティをサポートするために更新されました。 セッション構成はドライブの Plugin WSMan: ディレクトリに項目として表示され、プロパティは各セッション構成の項目として表示されます。

WSMan プロバイダーは、この記事で説明する次のコマンドレットをサポートしています。

注意

ドライブのコマンドを使用して、 WSMan: 新しいプロパティの値を変更できます。 ただし、WSMan:PowerShell 2.0 のドライブを使用して、Windows PowerShell 3.0 で導入されたプロパティを変更することはできません。 エラーは生成されませんが、コマンドは有効ではありません これらの設定を変更するには、3.0 で WSMan ドライブWindows PowerShell使用します。

WSMan の構成: ドライブ

  • クライアント: クライアントを使用して、クライアントのさまざまな側面WS-Managementできます。 構成情報はレジストリに保存されます。

  • サービス: サービスのさまざまな側面を構成WS-Managementできます。 構成情報はレジストリに保存されます。

    注意

    サービス構成はサーバー構成と呼ばれることもあります。

  • シェル: リモート シェル アクセスを許可する設定 (AllowRemoteShellAccess) や同時実行ユーザーの最大数 (MaxConcurrentUsers) など、WS-Management シェルのさまざまな側面を構成できます。

  • リスナー: リスナーを作成して構成できます。 リスナーは WS-Management プロトコルを実装し、メッセージを送受信する管理サービスです。

  • プラグイン: プラグインは、さまざまな機能を提供するために、WS-Managementサービスによって読み込まれ、使用されます。 既定では、PowerShell には次の 3 つのプラグインがあります。

    • イベント転送プラグイン。
    • Microsoft.PowerShell プラグイン。
    • Windows Management Instrumentation (WMI) プロバイダー プラグイン。 これら 3 つのプラグインは、イベント転送、構成、および WMI アクセスをサポートします。

  • ClientCertificate: クライアント証明書を作成して構成できます。 証明書認証を使用するように WS-Management クライアントが構成されているとき、クライアント証明書が使用されます。

WSMan プロバイダーのディレクトリ階層

ローカル コンピューターの WSMan プロバイダーのディレクトリ階層は次のとおりです。

WSMan:\localhost
--- Client
--- Service
--- Shell
--- Listener
------ <Specific_Listener>
--- Plugin
------ Event Forwarding Plugin
--------- InitializationParameters
--------- Resources
------------ Security
------ Microsoft.Powershell
--------- InitializationParameters
--------- Resources
------------ Security
------ WMI Provider
--------- InitializationParameters
--------- Resources
------------ Security
--- ClientCertificate

リモート コンピューターの WSMan プロバイダーのディレクトリ階層はローカル コンピューターと同じです。 ただし、リモート コンピューターの構成設定にアクセスするには、Connect-WSMan を利用し、リモート コンピューターに接続する必要があります。 リモート コンピューターに接続すると、リモート コンピューターの名前がプロバイダーに表示されます。

WSMan:\<Remote_Computer_Name>

このコマンドは、 コマンドレットを Set-Location 使用して、現在の場所をドライブに変更 WSMan: します。

Set-Location WSMan:

ファイル システム ドライブに戻るには、ドライブ名を入力します。 たとえば、「」と入力します。

Set-Location C:

このコマンドは、 コマンドを Set-Location 使用して、現在の場所をリモート システム ストアの場所のルートの場所に変更します。 円記号またはスラッシュを \ 使用して / 、ドライブのレベルを示 WSMan: します。

Set-Location -Path  WSMan:\SERVER01

注意

上記のコマンドでは、リモート システムにすでに接続しているものと仮定しています。

WSMan: ドライブの内容の表示

このコマンドは、 コマンドレット Get-Childitem を使用して、Localhost ストアWS-Managementストアの場所に格納されているストアを表示します。

Get-ChildItem -path WSMan:\Localhost

ドライブを使用している場合 WSMan: は、ドライブ名を省略できます。

このコマンドは、 コマンドレット Get-Childitem を使用して、リモート WS-Management "SERVER01" ストアの場所に格納されているファイルを表示します。

Get-ChildItem -path WSMan:\SERVER01

注意

上記のコマンドでは、リモート システムにすでに接続しているものと仮定しています。

WSMAN ドライブの項目の値の設定

コマンドレットを使用して Set-Item 、ドライブの構成設定を変更 WSMAN できます。 次の例では、 TrustedHosts 値を設定して 、サフィックスが "contoso.com" であるすべてのホストを受け入 contoso.com。

# You do not need to specify the -Path parameter name when using Set-Item.
PS WSMAN:\localhost\Client> Set-Item .\TrustedHosts -Value "*.contoso.com"

コマンドレット Set-Item は、値を変更する代 -Concatenate わりに値を追加する追加のパラメーターをサポートしています。 次の例では、 に格納されている古い値に新しい値 "*.domain2.com" を追加します。 TrustedHost:

Set-Item WSMAN:\localhost\Client\TrustedHosts *.domain2.com -Concatenate

WSMAN ドライブでの項目の作成

新しいリスナーの作成

コマンドレット New-Item は、プロバイダー ドライブ内に項目を作成します。 各プロバイダーには、作成できるさまざまな項目の種類があります。 ドライブでは WSMAN: 、リモート要求を 受信して 応答するために構成するリスナーを作成できます。 次のコマンドでは、 コマンドレットを使用して新しい HTTP リスナーを作成 New-Item します。

New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force

新しいプラグインの作成

このコマンドを実行すると、WS-Management サービスのプラグインが作成 (登録) されます。

New-Item -Path WSMan:\localhost\Plugin `
         -Plugin TestPlugin `
         -FileName %systemroot%\system32\WsmWmiPl.dll `
         -Resource http://schemas.dmtf.org/wbem/wscim/2/cim-schema `
         -SDKVersion 1 `
         -Capability "Get","Put","Invoke","Enumerate" `
         -XMLRenderingType text

新しいリソース エントリの作成

このコマンドは、TestPlugin の Resources ディレクトリにリソース エントリを作成します。 このコマンドは、TestPlugin が別のコマンドを使用して作成されたと想定しています。

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\Resources `
         -ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema `
         -Capability "Enumerate"

リソースの新しいセキュリティ エントリの作成

このコマンドを実行すると、Resource_5967683 (特定のリソース) の Security ディレクトリでセキュリティ エンティティが作成されます。 このコマンドは、リソース エントリが別のコマンドを使用して作成されたと想定しています。

$path = "WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683"
New-Item -Path $path\Security `
         -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"

新しいクライアント証明書の作成

このコマンドは、クライアントで使用できる ClientCertificate エントリWS-Managementします。 新しい ClientCertificate は ClientCertificate ディレクトリの下に "ClientCertificate_1234567890" と表示されます。 すべてのパラメーターが必須です。 発行 者は 、発行者証明書の拇印である必要があります。

$cred = Get-Credential
New-Item -Path WSMan:\localhost\ClientCertificate `
         -Issuer 1b3fd224d66c6413fe20d21e38b304226d192dfe `
         -URI wmicimv2/* `
         -Credential $cred;

新しい初期化パラメーターの作成

このコマンドは、"InitializationParameters" ディレクトリに "testparametername" という名前の初期化パラメーターを作成します。 このコマンドは、別のコマンドを使用して "TestPlugin" が作成されたと想定しています。

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\InitializationParameters `
         -ParamName testparametername `
         -ParamValue testparametervalue

動的パラメーター

動的パラメーターは、PowerShell プロバイダーによって追加されるコマンドレット パラメーターであり、プロバイダーが有効なドライブでコマンドレットが使用されている場合にのみ使用できます。

アドレス <String>

このリスナーが作成されたアドレスを指定します。 値は次のいずれかになります。

  • リテラル文字列 "*" 。 (ワイルドカード文字 (*) を使用すると、コマンドによってすべてのネットワーク アダプター上のすべての IP アドレスがバインドされます。
  • リテラル文字列 "IP:" の後に、IPv4 ドット 10 進数形式または IPv6 複製された 16 進数形式の有効な IP アドレスが続きます。
  • リテラル文字列 "MAC:" の後にアダプターの MAC アドレスが続きます。 例: MAC:32-a3-58-90-be-cc。

注意

Address 値はリスナーの作成時に設定されます。

サポートされているコマンドレット

Capability <Enumeration>

プラグインを 使用する場合、この パラメーターは、このパラメーター (URI) でサポートされる操作Uniform Resource Identifier指定します。 URI でサポートされる操作の種類ごとに 1 つのエントリを作成する必要があります。 操作でサポートされている場合は、特定の操作に対して有効な属性を指定できます。

これらの属性には 、SupportsFiltering と SupportsFragment が含まれます。

  • 作成: 作成操作は URI でサポートされています。
    • 作成操作で 概念が サポートされている場合は、SupportFragment 属性が使用されます。
    • SupportFiltering 属性は Create 操作には有効ではなく、"False" に設定する必要があります。

    注意

    Shell 操作もサポートされている場合、URI に対してこの操作は有効ではありません。

  • 削除: 削除操作は URI でサポートされています。
    • Delete 操作で 概念が サポートされている場合は、SupportFragment 属性が使用されます。
    • SupportFiltering 属性は Delete 操作には有効ではなく、"False" に設定する必要があります。

    注意

    Shell 操作もサポートされている場合、URI に対してこの操作は有効ではありません。

  • 列挙: 列挙操作は URI でサポートされています。
    • SupportFragment 属性は 列挙操作ではサポートされていません。False に設定する必要があります。
    • SupportFiltering 属性 は有効であり、プラグインでフィルター処理がサポートされている場合は、この属性を "True" に設定する必要があります。

    注意

    Shell 操作もサポートされている場合、URI に対してこの操作は有効ではありません。

  • Get: 取得操作は URI でサポートされています。
    • SupportFragment 属性は、Get 操作で概念がサポートされている場合に使用されます。
    • SupportFiltering 属性は Get 操作には有効ではなく、"False" に設定する必要があります。

    注意

    Shell 操作もサポートされている場合、URI に対してこの操作は有効ではありません。

  • 呼 び出し: 呼び出し操作は URI でサポートされています。
    • SupportFragment 属性は 呼び出し操作ではサポートされていません。False に設定する必要があります。
    • SupportFiltering 属性は 無効であり、"False" に設定する必要があります。

    注意

    Shell 操作もサポートされている場合、URI に対してこの操作は有効ではありません。

  • Put: PUT 操作は URI でサポートされています。
    • Put 操作で概念が サポートされている場合は、SupportFragment 属性が使用されます。
    • SupportFiltering 属性は Put 操作では有効ではなく、"False" に設定する必要があります。

    注意

    Shell 操作もサポートされている場合、URI に対してこの操作は有効ではありません。

  • Subscribe: サブスクライブ操作は URI でサポートされています。
    • SupportFragment 属性は Subscribe 操作ではサポートされていません。False に設定する必要があります。
    • SupportFiltering 属性は サブスクライブ操作には無効であり、"False" に設定する必要があります。

    注意

    Shell 操作もサポートされている場合、URI に対してこの操作は有効ではありません。

  • シェル: シェル操作は URI でサポートされています。
    • SupportFragment 属性は シェル操作ではサポートされていません。"False" に設定する必要があります。
    • SupportFiltering 属性は シェル操作では有効ではなく、"False" に設定する必要があります。

    注意

    他の任意の操作もサポートされている場合、この操作は URI に対して有効ではありません。

    注意

    Shell 操作が URI に構成されている場合、Get、Put、Create、Delete、Invoke、Enumerate 操作は WS-Management (WinRM) サービスの内部で処理され、シェルを管理します。 結果として、プラグインは操作を処理できません。

サポートされているコマンドレット

CertificateThumbprint <String>

サービス証明書の拇印を指定します。

この値は証明書の拇印フィールドの 2 桁の 16 進数値の文字列を表します。 この処理を実行するアクセス許可を持つユーザー アカウントのデジタル公開キー証明書 (X509) を指定します。 証明書は、クライアント証明書ベースの認証で使用されます。 これらの証明書はローカル ユーザー アカウントにしかマップできません。ドメイン アカウントでは機能しません。 証明書の拇印を取得するには、 Get-Item Get-ChildItem PowerShell ドライブの コマンドレットまたは コマンドレットを使用 Cert: します。

サポートされているコマンドレット

Enabled <Boolean>

リスナーが有効であるか、無効であるかを指定します。 既定値は True です。

サポートされているコマンドレット

FileName (Plugin) <String>

操作プラグインのファイル名を指定します。 このエントリに含まれる環境変数は、要求を受信するとユーザーのコンテキストで展開されます。 各ユーザーは同じ環境変数の異なるバージョンを持つ可能性があるため、各ユーザーは異なるプラグインを持つ可能性があります。 このエントリは空白にすることはできません。また、有効なプラグインを指している必要があります。

サポートされているコマンドレット

HostName <String>

WS-Management (WinRM) サービスが実行されているコンピューターのホスト名を指定します。

値は完全修飾ドメイン名、IPv4 または IPv6 のリテラル文字列、またはワイルドカード文字にする必要があります。

サポートされているコマンドレット

Issuer <String>

証明書を発行した証明機関の名前を指定します。

サポートされているコマンドレット

プラグイン <> WS-Managementプラグインはネイティブ ダイナミック リンク ライブラリ (DLL) です

をにプラグインし、 の機能を拡張WS-Management。 WSW-Management プラグイン API には、サポートされているリソース URI と操作に対して特定の API を実装することで、ユーザーがプラグインを記述できる機能が提供されています。 WS-Management (WinRM) サービスと Internet Information Services (IIS) のいずれかにプラグインを構成すると、WS-Management ホストと IIS ホストにそれぞれプラグインが読み込まれます。 リモート要求はこれらのプラグイン エントリ ポイントに送信され、操作が実行されます。

サポートされているコマンドレット

Port <Unsigned Short Integer>

このリスナーが作成された TCP ポートを指定します。 1 から 65535 までの値を指定できます。

サポートされているコマンドレット

Resource <String>

はっきりと識別できる種類の管理操作または値を表すエンドポイントを指定します。 サービスは 1 つまたは複数のリソースを公開します。一部のリソースには複数のインスタンスが含まれることがあります。 管理リソースは WMI クラスまたはデータベース テーブルに似ています。インスタンスはクラスのインスタンスまたはテーブルの行に似ています。 たとえば、 クラス Win32_LogicalDisk リソースを表します。 Win32_LogicalDisk="C:\\" は、リソースの特定のインスタンスです。

Uniform Resource Identifier (URI) にはリソースの接頭辞とパスが含まれます。 次に例を示します。

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

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

サポートされているコマンドレット

Resource <String>

ディスクまたはプロセスなど、コンピューター上の特定のリソースを識別する Uniform Resource Identifier (URI) を指定します。

URI は、プレフィックスとリソースのパスで構成されます。 次に例を示します。

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

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

サポートされているコマンドレット

SDKVersion <String>

WS-Management プラグイン SDK のバージョンを指定します。 唯一の有効な値 です。 1.

サポートされているコマンドレット

Subject <String>

証明書で識別されるエンティティを指定します。

サポートされているコマンドレット

Transport <String>

WS-Management プロトコルの要求と応答を送受信するためのトランスポートを指定します。 値は HTTP と HTTPS のいずれかになります。

注: トランスポート値はリスナーの作成時に設定されます。

サポートされているコマンドレット

URI <String>

アクセスが Sddl パラメーターの値に基づいて認証される URI を識別します。

サポートされているコマンドレット

URLPrefix <String>

HTTP 要求または HTTPS 要求を受け取る URL 接頭辞。 これは、文字 [a-z] [A-Z] [9-0] 、、、アンダースコア ( _ )、および円記号 ( / ) のみを含む文字列です。 文字列の先頭または末尾を円記号 ( / ) にすることはできません。 たとえば、コンピューター名が "SampleComputer" の場合、WS-Management クライアントは宛先アドレスでを指定 http://SampleMachine/URLPrefix します。

サポートされているコマンドレット

Value <String>

構成オプションを指定するプラグイン固有値である初期化パラメーターの値を指定します。

サポートされているコマンドレット

XMLRenderingType <String>

WSMAN_DATA オブジェクトを使用して、XML がプラグインに渡される形式を指定します。 有効な値は次のようになります。

  • Text: 受信 XML データは WSMAN_DATA_TYPE_TEXT 構造体に含まれており、これは Xml を PCWSTR メモリバッファーとして表します。
  • XMLReader: 受信 XML データは WSMAN_DATA_TYPE_WS_XML_READER 構造体に含まれています。これは、Xml を XmlReader オブジェクトとして表します。これは、"resource.h" ヘッダーファイルで定義されています。

サポートされているコマンドレット

パイプラインの使用

プロバイダーのコマンドレットは、パイプラインの入力を受け入れます。 パイプラインを使用すると、1つのコマンドレットから別のプロバイダーのコマンドレットにプロバイダーデータを送信することにより、タスクを簡単に行うことができます。 プロバイダーコマンドレットでパイプラインを使用する方法の詳細については、この記事全体で説明されているコマンドレットリファレンスを参照してください。

ヘルプの表示

Windows PowerShell 3.0 より、プロバイダー コマンドレットのためにカスタマイズされたヘルプ トピックを取得できます。これはファイル システム ドライブでのプロバイダー コマンドレットの動作を説明します。

ファイルシステムドライブ用にカスタマイズされたヘルプトピックを取得するには、ファイルシステムドライブでget-helpコマンドを実行するか、 get-helpのパラメーターを使用 -Path してファイルシステムドライブを指定します。

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

関連項目