Select-Xml

Referência

Módulo:: Microsoft.PowerShell.Utility

Localiza texto em uma cadeia de caracteres XML ou documento.

Sintaxe

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>]

Description

O cmdlet Select-Xml permite que você use consultas XPath para pesquisar texto em cadeias de caracteres XML e documentos. Insira uma consulta XPath e use o parâmetro Content, Pathou Xml para especificar o XML a ser pesquisado.

Exemplos

Exemplo 1: Selecionar nós AliasProperty

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

Este exemplo obtém as propriedades de alias no Types.ps1xml. (Para obter informações sobre esse arquivo, consulte about_Types.ps1xml.)

O primeiro comando salva o caminho para o arquivo Types.ps1xml na variável $Path.

O segundo comando salva o caminho XML no nó AliasProperty na variável $XPath.

O terceiro comando usa o cmdlet Select-Xml para obter os nós AliasProperty identificados pela instrução XPath do arquivo Types.ps1xml. O comando usa um operador de pipeline para enviar os nós AliasProperty para o cmdlet Select-Object. O parâmetro ExpandProperty expande o objeto Node e retorna suas propriedades Name e ReferencedMemberName.

O resultado mostra o Nome e ReferencedMemberName de cada propriedade de alias no arquivo Types.ps1xml. Por exemplo, há uma propriedade Count que é um alias da propriedade Length.

Exemplo 2: Inserir um documento XML

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

Este exemplo mostra como usar o parâmetro XML para fornecer um documento XML ao cmdlet Select-Xml.

O primeiro comando usa o cmdlet Get-Content para obter o conteúdo do arquivo Types.ps1xml e salvá-lo na variável $Types. O [xml] converte a variável como um objeto XML.

O segundo comando usa o cmdlet Select-Xml para obter os nós MethodName no arquivo Types.ps1xml. O comando usa o parâmetro Xml para especificar o conteúdo XML na variável $Types e o parâmetro XPath para especificar o caminho para o nó MethodName.

Exemplo 3: pesquisar arquivos de Ajuda do 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
...

Este exemplo mostra como usar o cmdlet Select-Xml para pesquisar os arquivos de ajuda de cmdlet baseados em XML do PowerShell. Neste exemplo, procuraremos o nome do cmdlet que serve como um título para cada arquivo de ajuda e o caminho para o arquivo de ajuda.

O primeiro comando cria uma tabela de hash que representa o namespace XML usado para os arquivos de ajuda e salva-o na variável $Namespace.

Exemplo 4: diferentes maneiras de inserir 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

Este exemplo mostra duas maneiras diferentes de enviar XML para o cmdlet Select-Xml.

O primeiro comando salva uma cadeia de caracteres aqui que contém XML na variável $Xml. (Para obter mais informações sobre cadeias de caracteres, consulte about_Quoting_Rules.)

Exemplo 5: Usar o namespace de xmlns padrão

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}

Este exemplo mostra como usar o cmdlet Select-Xml com documentos XML que usam o namespace xmlns padrão. O exemplo obtém os títulos dos arquivos de snippet criados pelo usuário do ISE do Windows PowerShell. Para obter informações sobre snippets, consulte New-IseSnippet.

O primeiro comando cria uma tabela de hash para o namespace padrão que os arquivos XML de snippet usam e a atribui à variável $SnippetNamespace. O valor da tabela de hash é o URI do esquema XMLNS no XML do snippet. O nome da chave da tabela de hash, snip, é arbitrário. Você pode usar qualquer nome que não esteja reservado, mas não pode usar xmlns.

Parâmetros

-Content

Especifica uma cadeia de caracteres que contém o XML a ser pesquisado. Você também pode canalizar cadeias de caracteres para Select-Xml.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-LiteralPath

Especifica os caminhos e os nomes de arquivo dos arquivos XML a serem pesquisados. Ao contrário docaminho , o valor do parâmetro LiteralPath é usado exatamente como ele é digitado. Nenhum caractere é interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. As aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Tipo:	String[]
Aliases:	PSPath
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Namespace

Especifica uma tabela de hash dos namespaces usados no XML. Use o formato @{<namespaceName> = <namespaceValue>}.

Quando o XML usa o namespace padrão, que começa com xmlns, use uma chave arbitrária para o nome do namespace. Você não pode usar xmlns. Na instrução XPath, prefixe cada nome de nó com o nome do namespace e dois-pontos, como //namespaceName:Node.

Tipo:	Hashtable
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Path

Especifica o caminho e os nomes de arquivo dos arquivos XML a serem pesquisados. Caracteres curinga são permitidos.

Tipo:	String[]
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	True

-Xml

Especifica um ou mais nós XML.

Um documento XML será processado como uma coleção de nós XML. Se você canalizar um documento XML para Select-Xml, cada nó de documento será pesquisado separadamente conforme ele vem pelo pipeline.

Tipo:	XmlNode[]
Aliases:	Node
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-XPath

Especifica uma consulta de pesquisa XPath. A linguagem de consulta diferencia maiúsculas de minúsculas. Esse parâmetro é necessário.

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

System.String or System.Xml.XmlNode

Você pode canalizar um caminho ou nó XML para este cmdlet.

Saídas

SelectXmlInfo

Observações

XPath é uma linguagem padrão projetada para identificar partes de um documento XML. Para obter mais informações sobre a linguagem XPath, consulte de Referência XPath e a seção Filtros de Seleção do de Seleção de Eventos na biblioteca MSDN.

ConvertTo-Xml

Compartilhar via

Select-Xml

Sintaxe

Description

Exemplos

Exemplo 1: Selecionar nós AliasProperty

Exemplo 2: Inserir um documento XML

Exemplo 3: pesquisar arquivos de Ajuda do PowerShell

Exemplo 4: diferentes maneiras de inserir XML

Exemplo 5: Usar o namespace de xmlns padrão

Parâmetros

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

Entradas

Saídas

Observações

Recursos adicionais

Compartilhar via

Select-Xml

Sintaxe

Description

Exemplos

Exemplo 1: Selecionar nós AliasProperty

Exemplo 2: Inserir um documento XML

Exemplo 3: pesquisar arquivos de Ajuda do PowerShell

Exemplo 4: diferentes maneiras de inserir XML

Exemplo 5: Usar o namespace de xmlns padrão

Parâmetros

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

Entradas

Saídas

Observações

Links Relacionados

Recursos adicionais