Select-Xml (Microsoft.PowerShell.Utility)

Select-Xml

Модуль:: Microsoft.PowerShell.Utility

Находит текст в строке или документе 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 позволяет использовать запросы XPath для поиска текста в строках и документах XML. Введите запрос XPath и используйте параметр Content, Path или Xml, чтобы указать XML для поиска.

Примеры

Пример 1. Выбор узлов AliasProperty

В этом примере получаются свойства псевдонима в Types.ps1xml. Сведения об этом файле см. в разделе about_Types.ps1xml.

Первая команда сохраняет путь к файлу Types.ps1xml в переменной $Path.

Вторая команда сохраняет путь XML к узлу AliasProperty в переменной $XPath.

Командлет Select-Xml получает узлы AliasProperty, которые идентифицируются оператором XPath, из файла Types.ps1xml. Команда использует оператор конвейера (|) для отправки узлов AliasProperty в командлет Select-Object. Параметр 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

В результате отображаются имя и ReferencedMemberName каждого свойства псевдонима в файле Types.ps1xml. Например, существует свойство Count, которое является псевдонимом свойства Length.

Пример 2. Введите XML-документ.

В этом примере показано, как использовать параметр XML для предоставления XML-документа командлету Select-Xml.

Командлет Get-Content получает содержимое файла Types.ps1xml и сохраняет его в переменной $Types. [xml] преобразует переменную как объект XML.

Командлет Select-Xml получает узлы MethodName в файле Types.ps1xml. Команда использует параметр Xml для указания содержимого XML в переменной $Types и параметр XPath для указания пути к . Имяметода node.

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

Пример 3. Поиск в файлах справки PowerShell

В этом примере показано, как использовать командлет Select-Xml для поиска в файлах справки командлета PowerShell на основе XML. В этом примере мы будем искать имя командлета, которое служит заголовком для каждого файла справки, и путь к файлу справки.

Переменная $Namespace содержит хеш-таблицу, представляющую пространство имен XML, используемое для файлов справки.

Переменная $Path содержит путь к файлам справки PowerShell. Если по этому пути на вашем компьютере нет файлов справки, используйте командлет Update-Help, чтобы загрузить файлы справки. Дополнительные сведения об обновляемой справке см. в разделе about_Updatable_Help.

Командлет Select-Xml ищет в файлах XML имена командлетов, находя элемент Command:Name в любом месте файлов. Результаты сохраняются в переменной $Xml. Select-Xml возвращает объект SelectXmlInfo, имеющий свойство Node, которое является объектом System.Xml.XmlElement. . Свойство Node имеет свойство InnerXML, которое содержит фактический полученный XML.

Переменная $Xml передается по конвейеру командлету Format-Table. Команда Format-Table использует вычисляемое свойство, чтобы получить свойство Node.InnerXML каждого объекта в переменной $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.

Первая команда сохраняет здесь строку, содержащую XML, в переменной $Xml. Дополнительные сведения о строках см. в разделе about_Quoting_Rules.

Select-Xml использует параметр Content для указания XML в переменной $Xml.

Третья команда аналогична второй, за исключением того, что tt использует оператор конвейера (|) для отправки XML из переменной $Xml в Select- Xml командлет.

$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 с XML-документами, которые используют пространство имен xmlns по умолчанию. В примере получаются заголовки файлов фрагментов Windows PowerShell ISE, созданных пользователем. Сведения о фрагментах см. в разделе New-IseSnippet.

Переменная $SnippetNamespace содержит хеш-таблицу для пространства имен по умолчанию, которое используют XML-файлы фрагментов. Значением хеш-таблицы является URI схемы XMLNS в XML-фрагменте. Имя ключа хеш-таблицы snip может быть произвольным. Вы можете использовать любое незарезервированное имя, но не можете использовать xmlns.

Командлет Select-Xml получает содержимое элемента Title каждого фрагмента. Он использует параметр Path для указания каталога фрагментов и параметр Namespace для указания пространства имен в переменной $SnippetNamespace. Значением параметра XPath является snip:Title. Результаты передаются командлету ForEach-Object, который получает заголовок из значения свойства 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
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-LiteralPath

Указывает пути и имена файлов XML для поиска. В отличие от Path, значение параметра LiteralPath используется точно так, как оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки сообщают PowerShell не интерпретировать никакие символы как escape-последовательности.

Тип :: String[]
Псевдонимы:: PSPath, LP
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Namespace

Указывает хеш-таблицу пространств имен, используемых в XML. Используйте формат@{=.

Если XML использует пространство имен по умолчанию, которое начинается с xmlns, используйте произвольный ключ для имени пространства имен. Вы не можете использовать xmlns. В операторе XPath добавьте перед каждым именем узла имя пространства имен и двоеточие, например //namespaceName:Node.

Тип :: Хэш-таблица
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

`-Path`

Указывает путь и имена файлов XML для поиска. Допускаются подстановочные знаки.

Тип :: String[]
Позиция:: 1
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: True

`-Xml`

Указывает один или несколько узлов XML.

XML-документ будет обрабатываться как набор узлов XML. Если вы передаете XML-документ в Select-Xml, каждый узел документа будет искаться отдельно по мере его прохождения по конвейеру.

Тип :: XmlNode[]
Псевдонимы:: Node
Позиция:: 1
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

`-XPath`

Указывает поисковый запрос XPath. Язык запросов чувствителен к регистру. Этот параметр является обязательным.

Тип :: String
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

`Входы`

System.String или System.Xml.XmlNode

В этот командлет можно передать путь или узел XML.

`Выходы`

ВыбратьXmlInfo

`Примечания`

XPath — это стандартный язык, предназначенный для идентификации частей XML-документа. Дополнительные сведения о языке XPath см. в справочнике по XPath и в разделе «Фильтры выбора» раздела «Выбор событий».