Select-Xml

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

Находит текст в xml-строке или документе.

Синтаксис

Xml (по умолчанию)

Select-Xml
    [-XPath] <string>
    [-Xml] <XmlNode[]>
    [-Namespace <hashtable>]
    [<CommonParameters>]

Path

Select-Xml
    [-XPath] <string>
    [-Path] <string[]>
    [-Namespace <hashtable>]
    [<CommonParameters>]

LiteralPath

Select-Xml
    [-XPath] <string>
    -LiteralPath <string[]>
    [-Namespace <hashtable>]
    [<CommonParameters>]

Content

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-путь к узлу псевдонима в переменной $XPath.

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

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

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

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

Переменная $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, обрезать пробел до и после текста и отобразить его в таблице, а также path в исходный файл.

$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. Дополнительные сведения о here-strings см. в 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. Сведения о фрагментах см. в разделе New-IseSnippet.

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

Командлет Select-Xml получает содержимое элемента Title каждого фрагмента кода. Он использует параметр path для указания каталога фрагментов и параметра пространства имен, чтобы указать пространство имен в переменной $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[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

Content

Position:	Named
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-LiteralPath

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

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	PSPath, LP

Наборы параметров

LiteralPath

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Namespace

Задает хэш-таблицу пространств имен, используемых в XML. Используйте формат@{<namespaceName> = <namespaceValue>}.

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

Свойства параметра

Тип:	Hashtable
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Path

Задает путь и имена файлов XML-файлов для поиска. Разрешено использование подстановочных символов.

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	True
DontShow:	False

Наборы параметров

Path

Position:	1
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Xml

Указывает один или несколько УЗЛОВ XML.

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

Свойства параметра

Тип:	XmlNode[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Узел

Наборы параметров

Xml

Position:	1
Обязательно:	True
Значение из конвейера:	True
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-XPath

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

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

System.String or System.Xml.XmlNode

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

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

SelectXmlInfo

Примечания

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

ConvertTo-Xml

Обратная связь

Были ли сведения на этой странице полезными?

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

Select-Xml

Синтаксис

Xml (по умолчанию)

Path

LiteralPath

Content

Описание

Примеры

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

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

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

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

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

Параметры

-Content

Свойства параметра

Наборы параметров

-LiteralPath

Свойства параметра

Наборы параметров

-Namespace

Свойства параметра

Наборы параметров

-Path

Свойства параметра

Наборы параметров

-Xml

Свойства параметра

Наборы параметров

-XPath

Свойства параметра

Наборы параметров

CommonParameters

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

System.String or System.Xml.XmlNode

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

SelectXmlInfo

Примечания

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

Обратная связь