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

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

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

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

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

Примечания

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

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

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