Select-Xml

模組:: Microsoft.PowerShell.Utility Module

在 XML 字串或文件中尋找文字。

語法

Xml (預設值)

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

Path

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

LiteralPath

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

Content

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

Description

這個 Select-Xml cmdlet 讓你可以用 XPath 查詢來搜尋 XML 字串和文件中的文字。輸入 XPath 查詢，並使用 Content、 Path 或 XML 參數指定要搜尋的 XML。

範例

範例 1：選擇 AliasProperty 節點

此範例取得 alias 屬性的 Types.ps1xml。關於此檔案的資訊，請參見 about_Types.ps1xml。

第一個指令會將檔案 Types.ps1xml 的路徑儲存在變數中 $Path 。

第二個指令將 XML 路徑儲存到 AliasProperty 節點。$XPath

Select-Xml指令檔會取得 XPath 語句所識別的 Types.ps1xml 節點。此指令使用管線運算子（|）將 AliasProperty 節點傳送至 Select-Object cmdlet。 ExpandProperty 參數會展開節點物件，並回傳其 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

結果顯示檔案中每個別名屬性的名稱與 Types.ps1xml。例如，有一個 Count 屬性是 Length 屬性的別名。

範例 2：輸入 XML 文件

此範例展示了如何使用 XML 參數向 cmdlet 提供 XML 文件 Select-Xml 。

Get-Content指令長會取得檔案內容Types.ps1xml並儲存在變數中$Types。它 [xml] 會將變數鑄造成 XML 物件。

指令Select-Xml長會取得檔案中的 Types.ps1xml 節點。此指令使用 Xml 參數來指定變數中的 $Types XML 內容，並使用 XPath 參數指定 MethodName 節點的路徑。

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

範例 3：搜尋 PowerShell 說明檔案

此範例展示了如何使用 Select-Xml cmdlet 搜尋基於 XML 的 PowerShell 指令碼說明檔。在這個範例中，我們將搜尋作為每個說明檔案標題的 cmdlet 名稱，以及該說明檔案的路徑。

變數包含 $Namespace 一個雜湊表，代表用於說明檔案的 XML 命名空間。

變 $Path 數包含 PowerShell 說明檔案的路徑。如果你的電腦路徑中沒有說明檔，請使用 Update-Help cmdlet 下載說明檔。欲了解更多關於可更新幫助的資訊，請參見 about_Updatable_Help。

Select-Xml指令長透過在檔案中任意尋找Command:Name元素來搜尋 XML 檔案中的指令長名稱。結果會儲存在變數中 $Xml 。 Select-Xml回傳一個具有節點屬性的 SelectXmlInfo 物件，該物件為 System.Xml.XmlElement 物件。 Node 屬性有一個 InnerXML 屬性，包含實際被檢索的 XML。

$Xml變數會被管道傳送到 Format-Table cmdlet。指令Format-Table使用 calculated 屬性取得變數中每個物件的 $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 傳送到 Select-Xml cmdlet。

第一個指令儲存一個包含 XML 的 $Xml here-字串。如需有關「here-strings」的詳細資訊，請參閱 about_Quoting_Rules。

Select-Xml 使用 Content 參數來指定變數中的 $Xml XML。

第三個指令與第二個相同，但 tt 使用管線運算子（|）將變數中的 $Xml XML 傳送給 Select-Xml cmdlet。

$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 命名空間

這個範例展示了如何使用 Select-Xml cmdlet 來處理使用預設 xmlns 命名空間的 XML 文件。範例中取自 Windows PowerShell ISE 使用者自製的片段檔案標題。關於片段的資訊，請參見 New-IseSnippet。

變數包含 $SnippetNamespace 一個預設命名空間的雜湊表，該命名空間是 XML 檔案所使用的。雜湊表的值是 XML 片段中的 XMLNS 架構 URI。雜湊表的鍵名 snip 是任意的。你可以使用任何未被保留的名字，但不能使用 xmlns。

指令 Select-Xml 小程式會取得每個片段 標題元素的內容 。它使用 Path 參數來指定 Snippets 目錄，並用 Namespace 參數來指定變數中的 $SnippetNamespace 命名空間。 XPath 參數的值為 snip:Title。結果會被傳送到 ForEach-Object cmdlet，其標題來自節點的 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。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

Content

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-LiteralPath

指定 XML 檔案的路徑與檔案名稱。不同於 Path，LiteralPath 參數的值完全按照輸入的方式使用。不會將任何字元解譯為通配符。如果路徑包含逸出字元，請以單引弧括住它。單引號會告知PowerShell不要將任何字元解譯為逸出序列。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	PSPath, LP

參數集

LiteralPath

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Namespace

指定 XML 中使用命名空間的雜湊表。使用這個格式@{<namespaceName> = <namespaceValue>}。

當 XML 使用預設命名空間（以 xmlns 開頭）時，請使用任意鍵作為命名空間名稱。你不能用 xmln。在 XPath 陳述中，每個節點名稱前置命名空間名稱及冒號，例如 //namespaceName:Node。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Path

指定要搜尋的 XML 檔案路徑與檔名。允許使用通配符字元。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	True
不要顯示:	False

參數集

Path

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Xml

指定一個或多個 XML 節點。

XML 文件將被處理為一組 XML 節點。如果你將 XML 文件管道輸入 Select-Xml到，每個文件節點在管道中會被分別搜尋。

參數屬性

類型:	XmlNode[]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	Node

參數集

Xml

Position:	1
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-XPath

指定一個 XPath 搜尋查詢。查詢語言是區分大小寫的。此為必要參數。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸入

System.String or System.Xml.XmlNode

你可以將路徑或 XML 節點輸入到這個 cmdlet。

輸出

SelectXmlInfo

備註

XPath 是一種標準語言，設計用來識別 XML 文件的部分。欲了解更多 XPath 語言資訊，請參閱 XPath 參考文獻及事件選擇的選擇篩選器章節。

轉換為 XML

意見反應

此頁面對您有幫助嗎？

Select-Xml

語法

Xml (預設值)

Path

LiteralPath

Content

Description

範例

範例 1：選擇 AliasProperty 節點

範例 2：輸入 XML 文件

範例 3：搜尋 PowerShell 說明檔案

範例 4：輸入 XML 的不同方式

範例 5：使用預設的 xmlns 命名空間

參數

-Content

參數屬性

參數集

-LiteralPath

參數屬性

參數集

-Namespace

參數屬性

參數集

-Path

參數屬性

參數集

-Xml

參數屬性

參數集

-XPath

參數屬性

參數集

CommonParameters

輸入

System.String or System.Xml.XmlNode

輸出

SelectXmlInfo

備註

相關連結

意見反應