Select-Xml

リファレンス

モジュール:: Microsoft.PowerShell.Utility

XML 文字列または XML ドキュメント内のテキストを検索します。

構文

Select-Xml
      [-XPath] <string>
      [-Xml] <XmlNode[]>
      [-Namespace <hashtable>]
      [<CommonParameters>]

Select-Xml
      [-XPath] <string>
      [-Path] <string[]>
      [-Namespace <hashtable>]
      [<CommonParameters>]

Select-Xml
      [-XPath] <string>
      -LiteralPath <string[]>
      [-Namespace <hashtable>]
      [<CommonParameters>]

Select-Xml
      [-XPath] <string>
      -Content <string[]>
      [-Namespace <hashtable>]
      [<CommonParameters>]

説明

この Select-Xml コマンドレットを使用すると、XPath クエリを使用して XML 文字列とドキュメント内のテキストを検索できます。 XPath クエリを入力し、Content、Path、または Xml パラメーターを使用して、検索する XML を指定します。

例

例 1: AliasProperty ノードの選択

この例では、.Types.ps1xml このファイルの詳細については、about_Types.ps1xml を参照してください。

最初のコマンドは、ファイルへのパスを Types.ps1xml 変数に $Path 保存します。

2 番目のコマンドは、変数の AliasProperty ノードへの XML パスを$XPath保存します。

このコマンドレットは Select-Xml 、 XPath ステートメントによって識別される AliasProperty ノードを Types.ps1xml ファイルから取得します。このコマンドでは、パイプライン演算子 (|) を使用して AliasProperty ノードをコマンドレットにSelect-Object送信します。 ExpandProperty パラメーターは、Node オブジェクトを展開し、その Name プロパティと ReferencedMemberName プロパティを返します。

$Path = "$Pshome\Types.ps1xml"
$XPath = "/Types/Type/Members/AliasProperty"
Select-Xml -Path $Path -XPath $Xpath | Select-Object -ExpandProperty Node

Name                 ReferencedMemberName
----                 --------------------
Count                Length
Name                 Key
Name                 ServiceName
RequiredServices     ServicesDependedOn
ProcessName          Name
Handles              Handlecount
VM                   VirtualSize
WS                   WorkingSetSize
Name                 ProcessName
Handles              Handlecount
VM                   VirtualMemorySize
WS                   WorkingSet
PM                   PagedMemorySize
NPM                  NonpagedSystemMemorySize
Name                 __Class
Namespace            ModuleName

結果には、ファイル内の各エイリアスプロパティの Name と ReferencedMemberName が Types.ps1xml 表示されます。たとえば、Length プロパティのエイリアスである Count プロパティがあります。

例 2: XML ドキュメントを入力する

この例では、XML パラメーターを使用して、コマンドレットに XML ドキュメントを提供する方法をSelect-Xml示します。

コマンドレットは Get-Content ファイルの内容を Types.ps1xml 取得し、変数に $Types 保存します。変数 [xml] を XML オブジェクトとしてキャストします。

コマンドレットは Select-Xml 、ファイル内の MethodName ノードを Types.ps1xml 取得します。このコマンドでは、Xml パラメーターを使用して変数内の XML コンテンツを$Types指定し、XPath パラメーターを使用して MethodName ノードへのパスを指定します。

[xml]$Types = Get-Content $Pshome\Types.ps1xml
Select-Xml -Xml $Types -XPath "//MethodName"

例 3: PowerShell ヘルプファイルを検索する

この例では、コマンドレットを使用 Select-Xml して PowerShell XML ベースのコマンドレットヘルプファイルを検索する方法を示します。各ヘルプファイルのタイトルとなるコマンドレット名とヘルプファイルのパスを検索します。

この $Namespace 変数には、ヘルプファイルに使用される XML 名前空間を表すハッシュテーブルが含まれています。

この $Path 変数には、PowerShell ヘルプファイルへのパスが含まれています。コンピューター上のこのパスにヘルプファイルがない場合は、コマンドレットを Update-Help 使用してヘルプファイルをダウンロードします。更新可能なヘルプの詳細については、「about_Updatable_Help」を参照してください。

コマンドレットは Select-Xml 、ファイル内の任意の場所にある要素を検索 Command:Name して、XML ファイルのコマンドレット名を検索します。結果は変数に $Xml 格納されます。 Select-Xmlは、System.Xml.XmlElement オブジェクトである Node プロパティを持つ SelectXmlInfo オブジェクトを返します。 Node プロパティには、取得される実際の XML を含む InnerXML プロパティがあります。

変数は $Xml コマンドレットに Format-Table パイプ処理されます。このコマンドではFormat-Table、計算プロパティを使用して、変数内の各オブジェクトの Node.InnerXML プロパティを$Xml取得し、テキストの前後の空白をトリミングし、ソースファイルへのパスと共にテーブルに表示します。

$Namespace = @{
    command = "http://schemas.microsoft.com/maml/dev/command/2004/10"
    maml = "http://schemas.microsoft.com/maml/2004/10"
    dev = "http://schemas.microsoft.com/maml/dev/2004/10"
}

$Path = "$Pshome\en-us\*dll-Help.xml"
$Xml = Select-Xml -Path $Path -Namespace $Namespace -XPath "//command:name"
$Xml | Format-Table @{Label="Name"; Expression= {($_.node.innerxml).trim()}}, Path -AutoSize

Name                    Path
----                    ----
Export-Counter          C:\Windows\system32\WindowsPowerShell\v1.0\en-us\Microsoft.PowerShell.Commands.Diagnostics.dll-Help.xml
Get-Counter             C:\Windows\system32\WindowsPowerShell\v1.0\en-us\Microsoft.PowerShell.Commands.Diagnostics.dll-Help.xml
Get-WinEvent            C:\Windows\system32\WindowsPowerShell\v1.0\en-us\Microsoft.PowerShell.Commands.Diagnostics.dll-Help.xml
Import-Counter          C:\Windows\system32\WindowsPowerShell\v1.0\en-us\Microsoft.PowerShell.Commands.Diagnostics.dll-Help.xml
Add-Computer            C:\Windows\system32\WindowsPowerShell\v1.0\en-us\Microsoft.PowerShell.Commands.Management.dll-Help.xml
Add-Content             C:\Windows\system32\WindowsPowerShell\v1.0\en-us\Microsoft.PowerShell.Commands.Management.dll-Help.xml
Checkpoint-Computer     C:\Windows\system32\WindowsPowerShell\v1.0\en-us\Microsoft.PowerShell.Commands.Management.dll-Help.xml
...

例 4: XML を入力するさまざまな方法

この例では、コマンドレットに XML を送信する 2 つの異なる方法を Select-Xml 示します。

最初のコマンドは、変数に XML を含む here 文字列を $Xml 保存します。 here-strings の詳細については、about_Quoting_Rulesを参照してください。

Select-Xmlは、Content パラメーターを使用して変数内の XML を$Xml指定します。

3 番目のコマンドは 2 番目と同じですが、tt はパイプライン演算子 (|) を使用して変数内の $Xml XML をコマンドレットに Select-Xml 送信することを除きます。

$Xml = @"
<?xml version="1.0" encoding="utf-8"?>
<Book>
  <projects>
    <project name="Book1" date="2009-01-20">
      <editions>
        <edition language="English">En.Book1.com</edition>
        <edition language="German">Ge.Book1.Com</edition>
        <edition language="French">Fr.Book1.com</edition>
        <edition language="Polish">Pl.Book1.com</edition>
      </editions>
    </project>
  </projects>
</Book>
"@

Select-Xml -Content $Xml -XPath "//edition" | foreach {$_.node.InnerXML}

En.Book1.com
Ge.Book1.Com
Fr.Book1.com
Pl.Book1.com

$Xml | Select-Xml -XPath "//edition" | foreach {$_.node.InnerXML}

En.Book1.com
Ge.Book1.Com
Fr.Book1.com
Pl.Book1.com

例 5: 既定の xmlns 名前空間を使用する

この例では、既定の xmlns 名前空間を Select-Xml 使用する XML ドキュメントでコマンドレットを使用する方法を示します。例として、ユーザーが作成した Windows PowerShell ISE のスニペットファイルのタイトルを取得します。スニペットの詳細については、「New-IseSnippet」を参照してください。

この $SnippetNamespace 変数には、スニペット XML ファイルで使用される既定の名前空間のハッシュテーブルが含まれています。ハッシュテーブルの値は、スニペット XML の XMLNS スキーマ URI です。ハッシュテーブルのキー名 snip は任意です。予約されていない任意の名前を使用できますが、xmlns を使用することはできません。

コマンドレットはSelect-Xml、各スニペットの Title 要素の内容を取得します。 Path パラメーターを使用して Snippets ディレクトリを指定し、Namespace パラメーターを使用して変数内の名前空間を$SnippetNamespace指定します。 XPath パラメーターの値は snip:Title. 結果はコマンドレットにForEach-Objectパイプ処理され、ノードの InnerXml プロパティの値からタイトルが取得されます。

$SnippetNamespace = @{snip = "http://schemas.microsoft.com/PowerShell/Snippets"}

Select-Xml -Path $HOME\Documents\WindowsPowerShell\Snippets -Namespace $SnippetNamespace -XPath "//snip:Title" |
    ForEach-Object {$_.Node.Innerxml}

パラメーター

-Content

検索対象の XML を含む文字列を指定します。文字列をパイプ Select-Xml処理することもできます。

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LiteralPath

検索対象の XML ファイルのパスとファイル名を指定します。 Path とは異なり、LiteralPath パラメーターの値は、型指定されたとおりに使用されます。ワイルドカードとして解釈される文字はありません。パスにエスケープ文字が含まれている場合は、単一引用符で囲みます。単一引用符は、エスケープシーケンスとして文字を解釈しないように PowerShell に指示します。

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Namespace

XML で使用されている名前空間のハッシュテーブルを指定します。 @{<namespaceName> = <namespaceValue>} という形式を使用します。

XML が xmlns で始まる既定の名前空間を使用する場合は、名前空間名に任意のキーを使用します。 xmlns を使用することはできません。 XPath ステートメントで、各ノード名の前に名前空間名とコロン (例: //namespaceName:Node.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

検索対象の XML ファイルのパスとファイル名を指定します。ワイルドカード文字を使用できます。

Type:	String[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Xml

1 つ以上の XML ノードを指定します。

XML ドキュメントは、XML ノードのコレクションとして処理されます。 XML ドキュメントをパイプ処理する Select-Xml場合、パイプラインを通過すると、各ドキュメントノードが個別に検索されます。

Type:	XmlNode[]
Aliases:	Node
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-XPath

XPath 検索クエリを指定します。クエリ言語では、大文字と小文字が区別されます。このパラメーターは必須です。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

入力

System.String or System.Xml.XmlNode

パスまたは XML ノードをこのコマンドレットにパイプできます。

出力

SelectXmlInfo

メモ

XPath は、XML ドキュメントの一部分を特定するために設計された標準言語です。 XPath 言語の詳細については、「イベント選択」の「XPath リファレンス」および「選択フィルター」セクションを参照してください。

ConvertTo-Xml

Select-Xml

構文

説明

例

例 1: AliasProperty ノードの選択

例 2: XML ドキュメントを入力する

例 3: PowerShell ヘルプファイルを検索する

例 4: XML を入力するさまざまな方法

例 5: 既定の xmlns 名前空間を使用する

パラメーター

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

入力

出力

メモ

フィードバック

その他のリソース

Select-Xml

構文

説明

例

例 1: AliasProperty ノードの選択

例 2: XML ドキュメントを入力する

例 3: PowerShell ヘルプ ファイルを検索する

例 4: XML を入力するさまざまな方法

例 5: 既定の xmlns 名前空間を使用する

パラメーター

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

入力

出力

メモ

関連リンク

フィードバック

その他のリソース

例 3: PowerShell ヘルプファイルを検索する