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

说明

该 Select-Xml cmdlet 允许使用 XPath 查询在 XML 字符串和文档中搜索文本。输入 XPath 查询，并使用 Content、 Path 或 Xml 参数指定要搜索的 XML。

示例

示例 1：选择 AliasProperty 节点

此示例获取 . 中的 Types.ps1xml别名属性。有关此文件的信息，请参阅 about_Types.ps1xml。

第一个命令将路径 Types.ps1xml 保存到变量中的 $Path 文件。

第二个命令将 XML 路径保存到变量中的 $XPath 节点。

该 Select-Xml cmdlet 从文件中获取由 XPath 语句标识的 Types.ps1xml 节点。该命令使用管道运算符（|）将 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。例如，有一个 Count 属性是 Length 属性的别名。

示例 2：输入 XML 文档

此示例演示如何使用 Xml 参数向 cmdlet 提供 XML 文档 Select-Xml 。

该 Get-Content cmdlet 获取文件的内容 Types.ps1xml ，并将其保存在变量中 $Types 。将 [xml] 变量强制转换为 XML 对象。

该 Select-Xml cmdlet 获取文件中 的 MethodName 节点 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 搜索基于 PowerShell XML 的 cmdlet 帮助文件。在此示例中，我们将搜索用作每个帮助文件的标题的 cmdlet 名称以及帮助文件的路径。

该 $Namespace 变量包含一个哈希表，该表表示用于帮助文件的 XML 命名空间。

变量 $Path 包含 PowerShell 帮助文件的路径。如果计算机上此路径中没有帮助文件，请使用 Update-Help cmdlet 下载帮助文件。有关可更新帮助的详细信息，请参阅 about_Updatable_Help。

该 Select-Xml cmdlet 通过查找 Command:Name 文件中的任何位置的元素来搜索 XML 文件以获取 cmdlet 名称。结果存储在变量中 $Xml 。 Select-Xml 返回一个 SelectXmlInfo 对象，该对象具有 Node 属性， 即 System.Xml.XmlElement 对象。 Node 属性具有 InnerXml 属性，该属性包含检索的实际 XML。

变量 $Xml 通过管道传递给 Format-Table cmdlet。该Format-Table命令使用计算属性获取变量中每个对象的 $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 发送到 cmdlet 的 Select-Xml 两种不同的方法。

第一个命令保存一个此处字符串，该字符串包含变量中的 $Xml XML。有关 here-string 的详细信息，请参阅 about_Quoting_Rules。

Select-Xml 使用 Content 参数在变量中 $Xml 指定 XML。

第三个命令与第二个命令相同，但 tt 使用管道运算符（|）将变量$Xml中的 Select-Xml 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 cmdlet 获取每个代码片段的 Title 元素的内容。它使用 Path 参数来指定代码段目录和 命名空间 参数，以在变量中 $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.

参数属性

类型:	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 开头的默认命名空间时，请使用命名空间名称的任意键。不能使用 xmlns。在 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 参考和选择筛选器部分。

ConvertTo-Xml

反馈

此页面是否有帮助？

Select-Xml

语法

Xml (默认值)

Path

LiteralPath

Content

说明

示例

示例 1：选择 AliasProperty 节点

示例 2：输入 XML 文档

示例 3：搜索 PowerShell 帮助文件

示例 4：输入 XML 的不同方法

示例 5：使用默认 xmlns 命名空间

参数

-Content

参数属性

参数集

-LiteralPath

参数属性

参数集

-Namespace

参数属性

参数集

-Path

参数属性

参数集

-Xml

参数属性

参数集

-XPath

参数属性

参数集

CommonParameters

输入

System.String or System.Xml.XmlNode

输出

SelectXmlInfo

备注

相关链接

反馈