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

Med cmdleten Select-Xml kan du använda XPath-frågor för att söka efter text i XML-strängar och dokument. Ange en XPath-fråga och använd parametern Content, Patheller XML för att ange vilken XML som ska sökas igenom.

Det här exemplet hämtar aliasegenskaperna i Types.ps1xml. Information om den här filen finns i about_Types.ps1xml.

Det första kommandot sparar sökvägen till Types.ps1xml-filen i variabeln $Path.

Det andra kommandot sparar XML-sökvägen till noden AliasProperty i variabeln $XPath.

Cmdleten Select-Xml hämtar AliasProperty noder som identifieras av XPath-instruktionen från Types.ps1xml-filen. Kommandot använder en pipelineoperator (|) för att skicka AliasProperty noder till cmdleten Select-Object. Parametern ExpandProperty expanderar objektet Node och returnerar egenskaperna Name och 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

Resultatet visar namnet och ReferencedMemberName för varje aliasegenskap i Types.ps1xml-filen. Det finns till exempel en egenskap Count som är ett alias för egenskapen Length.

Det här exemplet visar hur du använder parametern Xml för att tillhandahålla ett XML-dokument till cmdleten Select-Xml.

Cmdleten Get-Content hämtar innehållet i Types.ps1xml-filen och sparar den i variabeln $Types. [xml] omvandlar variabeln som ett XML-objekt.

Cmdleten Select-Xml hämtar noderna MethodName i filen Types.ps1xml. Kommandot använder parametern Xml för att ange XML-innehållet i variabeln $Types och parametern XPath för att ange sökvägen till noden MethodName.

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

Det här exemplet visar hur du använder cmdleten Select-Xml för att söka i powershell XML-baserade cmdlet-hjälpfiler. I det här exemplet söker vi efter cmdlet-namnet som fungerar som en rubrik för varje hjälpfil och sökvägen till hjälpfilen.

Variabeln $Namespace innehåller en hash-tabell som representerar xml-namnområdet som används för hjälpfilerna.

Variabeln $Path innehåller sökvägen till PowerShell-hjälpfilerna. Om det inte finns några hjälpfiler på den här sökvägen på datorn använder du cmdleten Update-Help för att ladda ned hjälpfilerna. Mer information om uppdateringsbar hjälp finns i about_Updatable_Help.

Cmdleten Select-Xml söker i XML-filerna efter cmdlet-namn genom att hitta Command:Name element var som helst i filerna. Resultatet lagras i variabeln $Xml. Select-Xml returnerar ett SelectXmlInfo- objekt som har egenskapen Node, som är ett System.Xml.XmlElement--objekt. Egenskapen Node har egenskapen InnerXml som innehåller den faktiska XML som hämtas.

Variabeln $Xml skickas till cmdleten Format-Table. Kommandot Format-Table använder en beräknad egenskap för att hämta egenskapen Node.InnerXml för varje objekt i variabeln $Xml, trimma det tomma utrymmet före och efter texten och visa den i tabellen, tillsammans med sökväg till källfilen.

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

Det här exemplet visar två olika sätt att skicka XML till Select-Xml cmdlet.

Det första kommandot sparar en here-string som innehåller XML i variabeln $Xml. Mer information om här-strängar finns i about_Quoting_Rules.

Select-Xml använder parametern Content för att ange XML i variabeln $Xml.

Det tredje kommandot är detsamma som det andra, förutom att tt använder en pipelineoperator (|) för att skicka XML-koden i variabeln $Xml till cmdleten 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

Det här exemplet visar hur du använder cmdleten Select-Xml med XML-dokument som använder xmlns-standardnamnområdet. I exemplet hämtas rubrikerna för Windows PowerShell ISE-användarskapade kodfragmentfiler. Information om kodfragment finns i New-IseSnippet.

Variabeln $SnippetNamespace innehåller en hash-tabell för det standardnamnområde som kodfragment-XML-filer använder. Värdet för hashtabellen är XMLNS-schema-URI:n i kodfragmentets XML. Namnet på hashtabellnyckeln, kodfragment, är godtyckligt. Du kan använda valfritt namn som inte är reserverat, men du kan inte använda xmlns.

Cmdleten Select-Xml hämtar innehållet i elementet Title i varje kodfragment. Den använder parametern Path för att ange katalogen Snippets och parametern Namespace för att ange namnområdet i variabeln $SnippetNamespace. Värdet för parametern XPath är snip:Title. Resultatet skickas till cmdleten ForEach-Object, som hämtar rubriken från värdet för InnerXml-egenskapen för noden.

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

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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka en sökväg eller XML-nod till den här cmdleten.

XPath är ett standardspråk som är utformat för att identifiera delar av ett XML-dokument. Mer information om XPath-språket finns i XPath-referens och avsnittet Urvalsfilter i händelseval.