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

В результате отображаются значения Name и 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 для указания пути к узлу MethodName .

[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 командлет.

Первая команда сохраняет строку here,которая содержит 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 по умолчанию. Команды в этом примере получают заголовки созданных пользователями файлов фрагментов ISE в оболочке Windows PowerShell. Подробные сведения о фрагментах см. в разделе New-IseSnippet.

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

Командлет Select-Xml получает содержимое элемента Title каждого фрагмента. Он использует параметр Path для указания каталога Snippets и параметр 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.

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 и в разделе Фильтры выбора событий.

ConvertTo-Xml

Поделиться через

Select-Xml

Синтаксис

Описание

Примеры

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

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

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

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

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

Параметры

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

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

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

Примечания

Дополнительные ресурсы

Поделиться через

Select-Xml

Синтаксис

Описание

Примеры

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

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

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

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

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

Параметры

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

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

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

Примечания

Связанные ссылки

Дополнительные ресурсы