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 ヘルプファイルをSearchする

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

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

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

コマンドレットは Select-Xml 、XML ファイル内の任意の場所で要素を検索 Command:Name して、コマンドレット名を検索します。結果は変数に $Xml 格納されます。 Select-Xmlは、Node プロパティ (System.Xml) を持つ SelectXmlInfo オブジェクトを返します。XmlElement オブジェクト。 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