Select-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 cmdlet 可让你使用 XPath 查询来搜索 XML 字符串和文档中的文本。 输入 XPath 查询,然后使用 Content、Path 或 Xml 参数指定要搜索的 XML

示例

示例 1:选择 AliasProperty 节点

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

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

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

Select-Xml cmdlet 从 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 文件中每个别名属性的名称和 ReferencedMemberName。 例如,存在 Count 属性,它是 Length 属性的别名

示例 2:输入 XML 文档

此示例展示了如何使用 XML 参数将 XML 文档提供给 Select-Xml cmdlet。

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

Select-Xml cmdlet 获取 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

Select-Xml cmdlet 通过在 XML 文件中查找位于文件中任意位置的 Command:Name 元素来搜索 cmdlet 名称。 结果存储在 $Xml 变量中。 Select-Xml 返回 SelectXmlInfo 对象,它具有 Node 属性,此属性是一个 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 的 here-string 保存在 $Xml 变量中。 有关 here-string 的详细信息,请参阅 about_Quoting_Rules

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

第三个命令与第二个命令相同,只不过前者使用管道运算符 (|) 将 $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 cmdlet 获取每个代码片段的 Title 元素内容。 它使用 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[]
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-LiteralPath

指定要搜索的 XML 文件的路径和文件名。 与 Path 不同,LiteralPath 参数的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。

类型:String[]
别名:PSPath, LP
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Namespace

指定在 XML 中使用的命名空间的哈希表。 使用 @{<namespaceName> = <namespaceValue>} 格式。

当 XML 使用以 xmlns 开头的默认命名空间时,可以为命名空间名称使用任意键。 不能使用 xmlns。 在 XPath 语句中,使用命名空间名称和一个冒号作为每个节点名称的前缀,例如 //namespaceName:Node

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Path

指定要搜索的 XML 文件的路径和文件名。 允许使用通配符。

类型:String[]
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:True

-Xml

指定一个或多个 XML 节点。

将作为 XML 节点的集合处理 XML 文档。 如果你通过管道将 XML 文档传递给 Select-Xml,则在它通过管道传入时,将单独搜索每个文档节点。

类型:XmlNode[]
别名:Node
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-XPath

指定 XPath 搜索查询。 查询语言区分大小写。 此参数是必需的。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

System.String or System.Xml.XmlNode

可以通过管道将路径或 XML 节点传递给此 cmdlet。

输出

SelectXmlInfo

备注

XPath 是一种标准语言,它可以识别 XML 文档的各个部分。 有关 XPath 语言的详细信息,请参阅 XPath 参考事件选择的“选择筛选器”部分。