Select-Xml

Referens

Modul:: Microsoft.PowerShell.Utility

Söker efter text i en XML-sträng eller ett dokument.

Syntax

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

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.

Exempel

Exempel 1: Välj AliasProperty-noder

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

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 filen Types.ps1xml i variabeln $Path.

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

Det tredje kommandot använder cmdleten Select-Xml för att hämta AliasProperty-noderna som identifieras av XPath-instruktionen från filen Types.ps1xml. Kommandot använder en pipelineoperator för att skicka AliasProperty-noderna till cmdleten Select-Object. Parametern ExpandProperty expanderar objektet Node och returnerar egenskaperna Name och ReferencedMemberName.

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

Exempel 2: Ange ett XML-dokument

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

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

Det första kommandot använder cmdleten Get-Content för att hämta innehållet i filen Types.ps1xml och spara det i variabeln $Types. [xml] omvandlar variabeln som ett XML-objekt.

Det andra kommandot använder cmdleten Select-Xml för att hämta MethodName-noderna 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.

Exempel 3: Sök i PowerShell-hjälpfiler

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

Det här exemplet visar hur du använder cmdleten Select-Xml för att söka i hjälpfilerna för PowerShell XML-baserade cmdletar. 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.

Det första kommandot skapar en hash-tabell som representerar XML-namnområdet som används för hjälpfilerna och sparar den i variabeln $Namespace.

Exempel 4: Olika sätt att mata in 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

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

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

Exempel 5: Använd xmlns-standardnamnområdet

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}

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.

Det första kommandot skapar en hash-tabell för standardnamnområdet som kodfragment-XML-filer använder och tilldelar den till variabeln $SnippetNamespace. Värdet för hashtabellen är XMLNS-schema-URI:n i kodfragmentets XML. Hash-tabellnyckelnamnet, kodfragmentet, är godtyckligt. Du kan använda valfritt namn som inte är reserverat, men du kan inte använda xmlns.

Parametrar

-Content

Anger en sträng som innehåller DEN XML som ska sökas efter. Du kan också skicka pipe-strängar för att Select-Xml-.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-LiteralPath

Anger sökvägarna och filnamnen för XML-filerna som ska sökas. Till skillnad från Pathanvänds värdet för parametern LiteralPath precis som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Typ:	String[]
Alias:	PSPath
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Namespace

Anger en hash-tabell med de namnområden som används i XML-koden. Använd formatet @{<namespaceName> = <namespaceValue>}.

När XML använder standardnamnområdet, som börjar med xmlns, använder du en godtycklig nyckel för namnområdesnamnet. Du kan inte använda xmlns. I XPath-instruktionen prefixar du varje nodnamn med namnområdesnamnet och ett kolon, till exempel //namespaceName:Node.

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Path

Anger sökvägen och filnamnen för XML-filerna som ska sökas. Jokertecken tillåts.

Typ:	String[]
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	True

-Xml

Anger en eller flera XML-noder.

Ett XML-dokument bearbetas som en samling XML-noder. Om du skickar ett XML-dokument till Select-Xml-genomsöks varje dokumentnod separat när den kommer via pipelinen.

Typ:	XmlNode[]
Alias:	Node
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-XPath

Anger en XPath-sökfråga. Frågespråket är skiftlägeskänsligt. Den här parametern krävs.

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

System.String or System.Xml.XmlNode

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

Utdata

SelectXmlInfo

Kommentarer

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 i MSDN-biblioteket.

ConvertTo-Xml

Dela via

Select-Xml

Syntax

Description

Exempel

Exempel 1: Välj AliasProperty-noder

Exempel 2: Ange ett XML-dokument

Exempel 3: Sök i PowerShell-hjälpfiler

Exempel 4: Olika sätt att mata in XML

Exempel 5: Använd xmlns-standardnamnområdet

Parametrar

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

Indata

Utdata

Kommentarer

Ytterligare resurser

Dela via

Select-Xml

Syntax

Description

Exempel

Exempel 1: Välj AliasProperty-noder

Exempel 2: Ange ett XML-dokument

Exempel 3: Sök i PowerShell-hjälpfiler

Exempel 4: Olika sätt att mata in XML

Exempel 5: Använd xmlns-standardnamnområdet

Parametrar

-Content

-LiteralPath

-Namespace

-Path

-Xml

-XPath

Indata

Utdata

Kommentarer

Relaterade länkar

Ytterligare resurser