Select-Xml

Riferimento

Modulo:: Microsoft.PowerShell.Utility

Trova testo in una stringa o in un documento XML.

Sintassi

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

Descrizione

Il cmdlet Select-Xml consente di usare query XPath per cercare testo in stringhe e documenti XML. Immettere una query XPath e usare il parametro Content, Patho Xml per specificare il codice XML da cercare.

Esempio

Esempio 1: Selezionare nodi AliasProperty

In questo esempio vengono recuperate le proprietà alias nel Types.ps1xml. Per informazioni su questo file, vedere about_Types.ps1xml.

Il primo comando salva il percorso del file Types.ps1xml nella variabile $Path.

Il secondo comando salva il percorso XML nel nodo AliasProperty nella variabile $XPath.

Il cmdlet Select-Xml ottiene il AliasProperty nodi identificati dall'istruzione XPath dal file Types.ps1xml. Il comando usa un operatore pipeline (|) per inviare i nodi aliasProperty al cmdlet Select-Object. Il parametro ExpandProperty espande l'oggetto Node di e restituisce le relative proprietà Name e 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

Il risultato mostra il Name e ReferencedMemberName di ogni proprietà alias nel file Types.ps1xml. Ad esempio, è presente una proprietà Count che rappresenta un alias della proprietà Length.

Esempio 2: Immettere un documento XML

In questo esempio viene illustrato come utilizzare il parametro XML per fornire un documento XML al cmdlet Select-Xml.

Il cmdlet Get-Content ottiene il contenuto del file Types.ps1xml e lo salva nella variabile $Types. Il [xml] esegue il cast della variabile come oggetto XML.

Il cmdlet Select-Xml ottiene i nodi MethodName nel file Types.ps1xml. Il comando usa il parametro Xml per specificare il contenuto XML nella variabile $Types e il parametro XPath per specificare il percorso del nodo MethodName.

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

Esempio 3: Cercare i file della Guida di PowerShell

Questo esempio illustra come usare il cmdlet Select-Xml per eseguire ricerche nei file della Guida dei cmdlet basati su XML di PowerShell. In questo esempio si cercherà il nome del cmdlet che funge da titolo per ogni file della Guida e il percorso del file della Guida.

La variabile $Namespace contiene una tabella hash che rappresenta lo spazio dei nomi XML utilizzato per i file della Guida.

La variabile $Path contiene il percorso dei file della Guida di PowerShell. Se nel computer non sono presenti file della Guida, usare il cmdlet Update-Help per scaricare i file della Guida. Per altre informazioni sulla Guida aggiornabile, vedere about_Updatable_Help.

Il cmdlet Select-Xml cerca i nomi dei cmdlet nei file XML individuando Command:Name elemento in qualsiasi punto dei file. I risultati vengono archiviati nella variabile $Xml. Select-Xml restituisce un oggetto SelectXmlInfo con una proprietà Node, che è un oggetto System.Xml.XmlElement. La proprietà Node dispone di una proprietà InnerXML contenente il codice XML effettivo recuperato.

La variabile $Xml viene inviata tramite pipe al cmdlet Format-Table. Il comando Format-Table usa una proprietà calcolata per ottenere la proprietà Node.InnerXML di ogni oggetto nella variabile $Xml, tagliare lo spazio vuoto prima e dopo il testo e visualizzarlo nella tabella, insieme al Path al file di origine.

$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
...

Esempio 4: modi diversi per l'input XML

In questo esempio vengono illustrati due modi diversi per inviare xml al cmdlet Select-Xml.

Il primo comando salva una stringa here contenente XML nella variabile $Xml. Per altre informazioni sulle stringhe qui, vedere about_Quoting_Rules.

Select-Xml usa il parametro content per specificare il codice XML nella variabile $Xml.

Il terzo comando è uguale al secondo, ad eccezione del fatto che tt usa un operatore pipeline (|) per inviare il codice XML nella variabile $Xml al cmdlet 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

Esempio 5: Usare lo spazio dei nomi xmlns predefinito

In questo esempio viene illustrato come utilizzare il cmdlet Select-Xml con documenti XML che usano lo spazio dei nomi xmlns predefinito. L'esempio ottiene i titoli dei file di frammento creati dall'utente di Windows PowerShell ISE. Per informazioni sui frammenti di codice, vedere New-IseSnippet.

La variabile $SnippetNamespace contiene una tabella hash per lo spazio dei nomi predefinito usato dai file XML del frammento di codice. Il valore della tabella hash è l'URI dello schema XMLNS nel frammento XML. Il nome della chiave della tabella hash, snip, è arbitrario. È possibile usare qualsiasi nome non riservato, ma non è possibile utilizzare xmlns.

Il cmdlet Select-Xml ottiene il contenuto dell'elemento title di ogni frammento. Usa il parametro Path per specificare la directory Snippets e il parametro Namespace per specificare lo spazio dei nomi nella variabile $SnippetNamespace. Il valore del parametro XPath è il snip:Title. I risultati vengono inviati tramite pipe al cmdlet ForEach-Object, che ottiene il titolo dal valore della proprietà InnerXml del nodo.

$SnippetNamespace = @{snip = "http://schemas.microsoft.com/PowerShell/Snippets"}

Select-Xml -Path $HOME\Documents\WindowsPowerShell\Snippets -Namespace $SnippetNamespace -XPath "//snip:Title" |
    ForEach-Object {$_.Node.InnerXml}

Parametri

-Content

Specifica una stringa contenente il codice XML da cercare. È anche possibile inviare tramite pipe stringhe a Select-Xml.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-LiteralPath

Specifica i percorsi e i nomi di file dei file XML da cercare. A differenza di Path, il valore del parametro LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come caratteri jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Tipo:	String[]
Alias:	PSPath, LP
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Namespace

Specifica una tabella hash degli spazi dei nomi utilizzati nel codice XML. Usare il formato@{<namespaceName> = <namespaceValue>}.

Quando il codice XML usa lo spazio dei nomi predefinito, che inizia con xmlns, usare una chiave arbitraria per il nome dello spazio dei nomi. Non è possibile usare xmlns. Nell'istruzione XPath anteporre a ogni nome di nodo il nome dello spazio dei nomi e i due punti, ad esempio //namespaceName:Node.

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Path

Specifica il percorso e i nomi di file dei file XML da cercare. Sono consentiti caratteri jolly.

Tipo:	String[]
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	True

-Xml

Specifica uno o più nodi XML.

Un documento XML verrà elaborato come raccolta di nodi XML. Se si invia tramite pipe un documento XML a Select-Xml, ogni nodo del documento verrà cercato separatamente man mano che passa attraverso la pipeline.

Tipo:	XmlNode[]
Alias:	Node
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-XPath

Specifica una query di ricerca XPath. Il linguaggio di query fa distinzione tra maiuscole e minuscole. Questo parametro è obbligatorio.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

System.String or System.Xml.XmlNode

È possibile inviare tramite pipe un percorso o un nodo XML a questo cmdlet.

Output

SelectXmlInfo

Note

XPath è un linguaggio standard progettato per identificare parti di un documento XML. Per altre informazioni sul linguaggio XPath, vedere di riferimento XPath e la sezione Filtri di selezione di Selezione eventi.

ConvertTo-Xml

Condividi tramite

Select-Xml

Sintassi

Descrizione

Esempio

Esempio 1: Selezionare nodi AliasProperty

Esempio 2: Immettere un documento XML

Esempio 3: Cercare i file della Guida di PowerShell

Esempio 4: modi diversi per l'input XML

Esempio 5: Usare lo spazio dei nomi xmlns predefinito

Parametri

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

Input

Output

Note

Risorse aggiuntive

Condividi tramite

Select-Xml

Sintassi

Descrizione

Esempio

Esempio 1: Selezionare nodi AliasProperty

Esempio 2: Immettere un documento XML

Esempio 3: Cercare i file della Guida di PowerShell

Esempio 4: modi diversi per l'input XML

Esempio 5: Usare lo spazio dei nomi xmlns predefinito

Parametri

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

Input

Output

Note

Collegamenti correlati

Risorse aggiuntive