Select-Xml

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

Выполняет поиск текста в XML-строке или документе.

Синтаксис

Select-Xml
      [-Xml] <XmlNode[]>
      [-XPath] <String>
      [-Namespace <Hashtable>]
      [<CommonParameters>]
Select-Xml
      [-Path] <String[]>
      [-XPath] <String>
      [-Namespace <Hashtable>]
      [<CommonParameters>]
Select-Xml
      -LiteralPath <String[]>
      [-XPath] <String>
      [-Namespace <Hashtable>]
      [<CommonParameters>]
Select-Xml
      -Content <String[]>
      [-XPath] <String>
      [-Namespace <Hashtable>]
      [<CommonParameters>]

Описание

Командлет Select-Xml позволяет использовать запросы XPath для поиска текста в XML-строках и документах. Введите запрос XPath и используйте параметр Content, Path или Xml , чтобы указать XML для поиска.

Примеры

Пример 1. Выбор псевдонимаУзлы свойств

PS C:\> $Path = "$Pshome\Types.ps1xml"
PS C:\> $XPath = "/Types/Type/Members/AliasProperty"
PS C:\> 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. (Сведения об этом файле см. в разделе about_Types.ps1xml.)

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

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

Третья команда получает узлы AliasProperty узлы, обозначенные оператором XPath, из файла Types.ps1xml, с помощью командлета Select-Xml. Команда использует оператор конвейера для отправки узлов AliasProperty в командлет Select-Object. Параметр ExpandProperty расширяет объект Node и возвращает его свойства Name и ReferencedMemberName.

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

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

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

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

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

Вторая команда использует командлет Select-Xml для получения узлов MethodName из файла Types.ps1xml. С помощью параметра Xml команда определяет XML-содержимое из переменной $Types, а с помощью параметра XPath — указывает путь к узлу MethodName.

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

PS C:\> $Namespace = @{command = "https://schemas.microsoft.com/maml/dev/command/2004/10"; maml = "https://schemas.microsoft.com/maml/2004/10"; dev = "https://schemas.microsoft.com/maml/dev/2004/10"}

The second command saves the path to the help files in the $Path variable.If there are no help files in this path on your computer, use the Update-Help cmdlet to download the help files. For more information about Updatable Help, see about_Updatable_Help (https://go.microsoft.com/fwlink/?LinkId=235801).
PS C:\> $Path = "$Pshome\en-us\*dll-Help.xml"

The third command uses the **Select-Xml** cmdlet to search the XML for cmdlet names by finding Command:Name element anywhere in the files. It saves the results in the $Xml variable.**Select-Xml** returns a **SelectXmlInfo** object that has a Node property, which is a **System.Xml.XmlElement** object. The Node property has an InnerXML property, which contains the actual XML that is retrieved.
PS C:\> $Xml = Select-Xml -Path $Path -Namespace $Namespace -XPath "//command:name"

The fourth command sends the XML in the $Xml variable to the Format-Table cmdlet. The **Format-Table** command uses a calculated property to get the Node.InnerXML property of each object in the $Xml variable, trim the white space before and after the text, and display it in the table, along with the path to the source file.
PS C:\> $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
...

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

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

Пример 4. Различные способы ввода XML

PS C:\> $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>
"@

The second command uses the *Content* parameter of **Select-Xml** to specify the XML in the $Xml variable.
PS C:\> Select-Xml -Content $Xml -XPath "//edition" | foreach {$_.node.InnerXML}

En.Book1.com
Ge.Book1.Com
Fr.Book1.com
Pl.Book1.com

The third command is equivalent to the second. It uses a pipeline operator (|) to send the XML in the $Xml variable to the **Select-Xml** cmdlet.
PS C:\> $Xml | Select-Xml -XPath "//edition" | foreach {$_.node.InnerXML}

En.Book1.com
Ge.Book1.Com
Fr.Book1.com
Pl.Book1.com

В этом примере показаны два разных способа отправки XML в командлет Select-Xml .

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

Пример 5. Использование пространства имен xmlns по умолчанию

PS C:\> $SnippetNamespace = @{snip = "https://schemas.microsoft.com/PowerShell/Snippets"}

The second command uses the **Select-Xml** cmdlet to get the content of the Title element of each snippet. It uses the *Path* parameter to specify the Snippets directory and the *Namespace* parameter to specify the namespace in the $SnippetNamespace variable. The value of the *XPath* parameter is the "snip" namespace key, a colon (:), and the name of the Title element.The command uses a pipeline operator (|) to send each **Node** property that **Select-Xml** returns to the ForEach-Object cmdlet, which gets the title in the value of the **InnerXml** property of the node.
PS C:\> Select-Xml -Path $Home\Documents\WindowsPowerShell\Snippets -Namespace $SnippetNamespace -XPath "//snip:Title" | foreach {$_.Node.Innerxml}

В этом примере показано, как использовать командлет Select-Xml с XML-документами , которые используют пространство имен xmlns по умолчанию. Команды в этом примере получают заголовки созданных пользователями файлов фрагментов ISE в оболочке Windows PowerShell. Подробные сведения о фрагментах см. в разделе New-IseSnippet.

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

Параметры

-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 используется в точности так, как вводится. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки предписывают PowerShell не интерпретировать какие-либо символы как escape-последовательности.

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.

Выходные данные

SelectXmlInfo

Примечания

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