Get-ValueByObject

EulandaXtools — Funktionsreferenz

Get-ValueByObject

ÜBERSICHT

Liest verschachtelte Werte aus einem XML-Knoten oder einem PowerShell-Objekt mit Punktnotation.

SYNTAX

Get-ValueByObject [[-Node] <object>] [[-Path] <string>] [<CommonParameters>]

BESCHREIBUNG

Ermöglicht den Zugriff auf verschachtelte XML-Elemente (DOM) oder [pscustomobject]-Strukturen über einen Pfad in Punktnotation. Wird der Pfad nicht gefunden oder ist leer, wird $null zurückgegeben. Geeignet für generische Zugriffe auf strukturierte Daten in XML oder Objektform.

PARAMETER

-Node

Type: object

Das Ausgangsobjekt. Kann ein [System.Xml.XmlElement], [System.Xml.XmlNode] oder ein [pscustomobject] sein.

-Path

Type: string

Der Zugriffspfad in Punktnotation, z.B.. "Kunde.Anschrift.PLZ" oder "RECHNUNG.POSITION.MENGE".

AUSGABEN

object

Der Wert des gesuchten Elements oder '$null', wenn der Pfad nicht gefunden wurde.

BEISPIELE

# Liest den Wert 'MENGE' aus einem XML-Dokument per Punktnotation.
Get-ValueByObject -Node $xmlRoot -Path "EULANDA.RECHNUNG.POSITION.MENGE"
# Greift auf eine verschachtelte Eigenschaft eines PSCustomObject zu.
$data = [pscustomobject]@{
    Kunde = [pscustomobject]@{
        Name      = 'Christian'
        Anschrift = [pscustomobject]@{
            Strasse = 'Klaus-Conrad-Str. 1'
            Ort     = 'Hirschau'
            PLZ     = '92240'
        }
    }
}
Get-ValueByObject -Node $data -Path "Kunde.Anschrift.Strasse"