Select-Xml
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 |
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 ノードをこのコマンドレットにパイプできます。
出力
メモ
XPath は、XML ドキュメントの一部分を特定するために設計された標準言語です。 XPath 言語の詳細については、「 イベント選択」の「XPath リファレンス 」および「選択フィルター」セクション を参照してください。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示