Select-Xml

參考

模組:: Microsoft.PowerShell.Utility

尋找 XML 字串或檔案中的文字。

Syntax

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>]

Description

Cmdlet Select-Xml 可讓您使用 XPath 查詢來搜尋 XML 字串和檔中的文字。輸入 XPath 查詢，並使用 Content、 Path 或 Xml 參數指定要搜尋的 XML。

範例

範例 1：選取 AliasProperty 節點

這個範例會取得中的 Types.ps1xml別名屬性。如需此檔案的相關信息，請參閱 about_Types.ps1xml。

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

第二個命令會將 XML 路徑儲存至變數中的 $XPath AliasProperty 節點。

Cmdlet Select-Xml 會從Types.ps1xml檔案中取得 XPath 語句所識別的 AliasProperty 節點。命令會使用管線運算符（|）將 AliasProperty 節點傳送至 Select-Object Cmdlet。 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

結果會顯示檔案中Types.ps1xml每個別名屬性的 Name 和 ReferencedMemberName。例如，有 Count 屬性是 Length 屬性的別名。

範例 2：輸入 XML 檔

此範例示範如何使用 XML 參數將 XML 檔 Select-Xml 提供給 Cmdlet。

Cmdlet Get-Content 會取得檔案的內容 Types.ps1xml ，並將它儲存在變數中 $Types 。會將 [xml] 變數轉換成 XML 物件。

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

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

範例 3：搜尋 PowerShell 說明檔

此範例示範如何使用 Select-Xml Cmdlet 來搜尋以 PowerShell XML 為基礎的 Cmdlet 說明檔。在此範例中，我們將搜尋 Cmdlet 名稱，以作為每個說明檔的標題，以及說明檔的路徑。

變數 $Namespace 包含哈希表，代表用於說明檔的 XML 命名空間。

變數 $Path 包含PowerShell說明檔的路徑。如果計算機上此路徑中沒有任何說明檔，請使用 Update-Help Cmdlet 下載說明檔。如需可更新說明的詳細資訊，請參閱 about_Updatable_Help。

Cmdlet 會 Select-Xml 尋找 Command:Name 檔案中的任何位置的專案，以搜尋 XML 檔案中的 Cmdlet 名稱。結果會儲存在變數中 $Xml 。 Select-Xml會傳回具有 Node 屬性的 SelectXmlInfo 物件，這是 System.Xml.XmlElement 物件。 Node 屬性具有 InnerXML 屬性，其中包含擷取的實際 XML。

變數 $Xml 會透過管道傳送至 Format-Table Cmdlet。 Format-Table此命令會使用匯出屬性來取得變數中$Xml每個物件的 Node.InnerXML 屬性、在文字前後修剪空格符，並將它顯示在數據表中，以及來源檔案的路徑。

$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-string。如需 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。

Cmdlet Select-Xml 會取得每個代碼段的 Title 元素內容。它會使用 Path 參數來指定 Snippets 目錄和 Namespace 參數，以指定變數中的 $SnippetNamespace 命名空間。 XPath 參數的值是 snip:Title。結果會透過管線傳送至 ForEach-Object Cmdlet，此 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。

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

指定一或多個 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 節點傳送至此 Cmdlet。

輸出

SelectXmlInfo

備註

XPath 是一種標準語言，設計用來識別 XML 檔的部分。如需 XPath 語言的詳細資訊，請參閱事件選取範圍的 XPath 參考和選取範圍篩選一節。

ConvertTo-Xml

Select-Xml

Syntax

Description

範例

範例 1：選取 AliasProperty 節點

範例 2：輸入 XML 檔

範例 3：搜尋 PowerShell 說明檔

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

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

參數

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

輸入

輸出

備註

意見反應

其他資源

Select-Xml

Syntax

Description

範例

範例 1：選取 AliasProperty 節點

範例 2：輸入 XML 檔

範例 3：搜尋 PowerShell 說明檔

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

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

參數

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

輸入

輸出

備註

相關連結

意見反應

其他資源