PackageDeployment Modul Hilfe

Package Deployment Module

Test-XmlNode Cmdlet

Version 3.0.0.0

Test-XmlNode

Übersicht

Existenz eines Werts in einer XML-Datei

Syntax

Test-XmlNode [-NodeType] <String> [-Path] <String> [-XPathQuery] <String> [-ContinueOnError] [-Wow64] [[-Attribute] <String>] [[-Index] <Int32>] [[-Content] <String>] [[-HintPath] <String>] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Prüft die Existenz eines Wert in einer bestimmten XML-Datei. Neben der XML-Datei müssen Sie in dieser Bedingung auch festlegen, welcher Eintrag in der XML-Datei geprüft werden soll. Zu diesem Zweck legen Sie den Typ des Eintrags und eine XPath-Abfrage fest. Diese Abfrage funktioniert analog zum Befehl Read-XmlNode. Zusätzlich geben Sie den Gesuchten Inhalt ein. Als Platzhalter erlaubt sind * und ?. Lassen Sie das Feld leer, um auf einen leeren Inhalt zu prüfen.

Parameter

-Attribute <String>

Enthält den Namen des gesuchten Attributs, wenn Typ des Eintrags = Attribut ausgewählt wurde. Der Platzhalter * ist erlaubt.

Erforderlich

Nein

Position

3

Pipeline-Eingaben akzeptieren

Nein

-Content <String>

Legt für die Aktionen Hinzufügen und Ändern den XML-Inhalt fest, welcher in der XML-Datei ersetzt bzw. hinzugefügt werden soll. Die Verwendung von Variablen ist möglich.

Erforderlich

Nein

Position

5

Pipeline-Eingaben akzeptieren

Nein

-Context <String>

User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer.
UserPerService: Benutzerbezogener Befehl, Ausführung im Service-Kontext
Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.
ComputerPerService: Ausführung im Service-Kontext; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.

Erforderlich

Nein

Position

7

Pipeline-Eingaben akzeptieren

Nein

-ContinueOnError <SwitchParameter>

Setzt das Skript trotz eines aufgetretenen Fehlers im betreffenden Befehl fort

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-HintPath <String>

#TODO#

Erforderlich

Nein

Position

6

Pipeline-Eingaben akzeptieren

Nein

-Index <Int32>

Legt fest, welches Element gelesen werden soll, wenn die Abfrage mehrere Treffer in der XML-Datei zurückliefert. Zur Auswahl stehen: Erster Treffer (Vorgabe), Letzter Treffer, Bestimmter Index. Dazu muss angegeben werden an welcher Stelle der Trefferliste das gewünschte Element steht, z.B. 3 für das dritte Vorkommen in der XML-Datei.

Erforderlich

Nein

Position

4

Pipeline-Eingaben akzeptieren

Nein

-NodeType <String>

Auswahl des Typs des zu lesenden Teils der XML-Datei:
Element - Grundlegende Struktureinheit einer XML-Datei, die i.d.R. über einen Anfangs- und Ende-Tag verfügt.
Wird nach einem Element gesucht, enthält die Ergebnis-Variable nach Ausführung des Befehls das gesamte Element mit Anfangs- und Ende-Tag sowie dem vollständigen Inhalt zwischen diesen Tags. Die Suche nach einem Element gibt das vollständige Element zurück: z.B. <Object type="STRING">QueenMary</Object>.
Attribut eines Elements
Wird nach einem Attribut gesucht, enthält die Ergebnis-Variable nach Ausführung des Befehls den Wert des Attributs. Die Suche nach dem Attribut type im oben genannten Beispiel-Element ergibt: STRING
Inhalt eines Elements
Wird nach dem Inhalt gesucht, enthält die Ergebnis-Variable nach Ausführung des Befehls den gesamten Textinhalt des gesuchten Elements zwischen Anfangs- und Ende-Tag. Untergeordnete Elemente mit ihren zugehörigen Textinhalten sind nicht eingeschlossen. Die Suche nach dem Inhalt im oben genannten Beispiel-Element ergibt: QueenMary.

Erforderlich

Ja

Position

0

Pipeline-Eingaben akzeptieren

Nein

-Path <String>

Pfad und Name der zu lesenden XML-Datei. Falls nicht angegeben, wird die Erweiterung .XML automatisch verwendet.

Erforderlich

Ja

Position

1

Pipeline-Eingaben akzeptieren

Nein

-Wow64 <SwitchParameter>

Standardmäßig geht das PackageDeployment-Modul davon aus, auf 64-Bit Systemen in einem 64-Bit PowerShell-Prozess ausgeführt zu werden und greift daher bei Datei- und Registryzugriffen standardmäßig den Ablageort für 64-Bit Anwendungen (sofern dieser sich von dem für 32-Bit Anwendungen unterscheidet) zurück. Soll auf die 32-Bit Pendants (im Dateisystem %WinDir%\SysWOW64 statt %WinDir%\System32, in der Registry HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node statt HKEY_LOCAL_MACHINE\SOFTWARE) zugegriffen werden, verwenden Sie den -Wow64 Switch.

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-XPathQuery <String>

Identifikation des zu bearbeitenden Teils der XML-Datei mithilfe der XPath-Syntax. Beispiel einer XPath-Abfrage: //Sample/node1/node2/Object[@type="STRING"]. In diesem Beispiel wird das Element Object unter Sample/node1/node2 gesucht, für welches type="STRING" gilt. Da bei einer solchen Abfrage meist mehrere Elemente gefunden werden, müssen Sie zusätzlich den Index festlegen.

Erforderlich

Ja

Position

2

Pipeline-Eingaben akzeptieren

Nein

<CommonParameters>

Weitere Informationen zu 'common parameters' finden Sie mit dem Kommando "Get-Help about_CommonParameters".