Select-Xml

Modul:

Microsoft.PowerShell.Utility Module

Szöveg keresése XML-sztringben vagy dokumentumban.

Syntax

Xml (Alapértelmezett)

Select-Xml
    [-Xml] <XmlNode[]>
    [-XPath] <String>
    [-Namespace <Hashtable>]
    [<CommonParameters>]

Path

Select-Xml
    [-Path] <String[]>
    [-XPath] <String>
    [-Namespace <Hashtable>]
    [<CommonParameters>]

LiteralPath

Select-Xml
    [-XPath] <String>
    -LiteralPath <String[]>
    [-Namespace <Hashtable>]
    [<CommonParameters>]

Content

Select-Xml
    [-XPath] <String>
    -Content <String[]>
    [-Namespace <Hashtable>]
    [<CommonParameters>]

Description

A Select-Xml parancsmaggal XPath-lekérdezésekkel kereshet szöveget XML-sztringekben és dokumentumokban. Adjon meg egy XPath-lekérdezést, és használja a Tartalom, Elérési útvagy Xml paramétert a keresendő XML megadásához.

Példák

1. példa: AliasProperty csomópontok kiválasztása

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

Ez a példa lekéri az alias tulajdonságait a Types.ps1xml fájlban. (A fájlról további információt a about_Types.ps1xml című témakörben talál.)

Az első parancs menti a Types.ps1xml fájl elérési útját a $Path változóban.

A második parancs menti az XML-elérési utat a $XPath változó AliasProperty csomópontjára.

A harmadik parancs a Select-Xml parancsmaggal szerzi be az XPath utasítás által a Types.ps1xml fájlból azonosított AliasProperty-csomópontokat. A parancs egy folyamatkezelővel küldi el az AliasProperty csomópontokat a Select-Object parancsmagba. Az ExpandProperty paraméter kiterjeszti a Node objektumot, és visszaadja a Név és a HivatkozottMemberName tulajdonságokat.

Az eredmény a Types.ps1xml fájlban lévő egyes aliastulajdonságok Neve és ReferencedMemberName neve. Létezik például egy Darabszám tulajdonság, amely a Hossz tulajdonság aliasa.

2. példa: XML-dokumentum bevitele

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

Ez a példa bemutatja, hogyan használható a XML paraméter az XML-dokumentum Select-Xml parancsmaghoz való megadásához.

Az első parancs a Get-Content parancsmaggal lekéri a Types.ps1xml fájl tartalmát, és menti a $Types változóba. Az [xml] XML-objektumként öntötte a változót.

A második parancs a Select-Xml parancsmaggal szerzi be a MethodName csomópontokat a Types.ps1xml fájlban. A parancs a Xml paraméter használatával adja meg a $Types változó XML-tartalmát, az XPath paraméter pedig a MethodName csomópont elérési útját.

3. példa: PowerShell-súgófájlok keresése

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

Ez a példa bemutatja, hogyan használhatja a Select-Xml parancsmagot a PowerShell XML-alapú parancsmag súgófájljaiban való kereséshez. Ebben a példában az egyes súgófájlok címként szolgáló parancsmag nevét és a súgófájl elérési útját keressük.

Az első parancs létrehoz egy kivonattáblát, amely a súgófájlokhoz használt XML-névteret jelöli, és menti a $Namespace változóba.

4. példa: Az XML bevitelének különböző módjai

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

Ez a példa két különböző módon küldhet XML-t a Select-Xml parancsmagnak.

Az első parancs egy XML-t tartalmazó ide-sztringet ment a $Xml változóba. (További információ az itt szereplő sztringekről: about_Quoting_Rules.)

5. példa: Az alapértelmezett xmlns-névtér használata

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}

Ez a példa bemutatja, hogyan használható a Select-Xml parancsmag az alapértelmezett xmlns-névteret használó XML-dokumentumokkal. A példa lekéri a Windows PowerShell ISE felhasználó által létrehozott kódrészletfájljainak címét. A kódrészletekről további információt a New-IseSnippet című témakörben talál.

Az első parancs létrehoz egy kivonattáblát az XML-fájlok által használt alapértelmezett névtérhez, és hozzárendeli az $SnippetNamespace változóhoz. A kivonattábla értéke az XML kódrészlet XML-kódrészletének XMLNS-séma URI-ja. A kivonattábla kulcsának neve (snip) tetszőleges. Bármilyen olyan nevet használhat, amely nincs lefoglalva, de xmlneket nem használhat.

Paraméterek

-Content

A keresendő XML-t tartalmazó sztringet adja meg. Sztringeket is csövezhet a Select-Xml.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Content

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-LiteralPath

Megadja a keresendő XML-fájlok elérési útját és fájlneveit. A Path-tal ellentétben a LiteralPath paraméter értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	PSPath

Paraméterkészletek

LiteralPath

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Namespace

Az XML-ben használt névterek kivonattábláját adja meg. Használja a @{<namespaceName> = <namespaceValue>} formátumot.

Amikor az XML az alapértelmezett névteret használja, amely xmlnekkel kezdődik, használjon tetszőleges kulcsot a névtérnévhez. Xmlneket nem használhat. Az XPath utasításban minden csomópontnév előtagja a névtér nevével és egy kettősponttal, például //namespaceName:Node.

Paramétertulajdonságok

Típus:	Hashtable
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Path

Megadja a keresendő XML-fájlok elérési útját és fájlneveit. A helyettesítő karakterek használata engedélyezett.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

Path

Position:	1
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Xml

Egy vagy több XML-csomópontot határoz meg.

Az XML-dokumentumok XML-csomópontok gyűjteményeként lesznek feldolgozva. Ha egy XML-dokumentumot Select-Xml, a rendszer minden dokumentumcsomópontot külön keres a folyamat során.

Paramétertulajdonságok

Típus:	XmlNode[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Node

Paraméterkészletek

Xml

Position:	1
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-XPath

XPath keresési lekérdezést ad meg. A lekérdezés nyelve megkülönbözteti a kis- és nagybetűk nyelvét. Ez a paraméter kötelező.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

System.String or System.Xml.XmlNode

Ehhez a parancsmaghoz elérési utat vagy XML-csomópontot is csövezhet.

Kimenetek

SelectXmlInfo

Jegyzetek

• Az XPath egy szabványos nyelv, amely egy XML-dokumentum részeinek azonosítására szolgál. Az XPath nyelvvel kapcsolatos további információkért tekintse meg XPath-referencia és az MSDN-kódtár eseménykijelölési kijelölési szűrők szakaszát.

Kapcsolódó hivatkozások

• Átalakítás XML formátummá