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>]
说明
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 参数向 cmdlet 提供 XML 文档 Select-Xml
。
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
通过在文件中的任何位置查找元素,在 XML 文件中搜索 Command:Name
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 发送到 cmdlet 的 Select-Xml
两种不同方法。
第一个命令将包含 XML 的 here 字符串保存在 变量中 $Xml
。 有关 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。 哈希表键名称 截图是任意的。 可以使用任何未保留的名称,但不能使用 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。
输出
备注
XPath 是一种标准语言,它可以识别 XML 文档的各个部分。 有关 XPath 语言的详细信息,请参阅事件选择的 XPath 参考和选择筛选器部分。