PackageDeployment Modul Hilfe

Package Deployment Module

Read-XmlNode Cmdlet

Version 3.0.0.0

-Attribute <String>

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

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

-ContinueOnError <SwitchParameter>

Setzt das Skript trotz eines aufgetretenen Fehlers im betreffenden Befehl fort

-HintPath <String>

#TODO#

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

-IndexVariable <String>

Legt die Variable fest, in welcher der Index des verwendeten Treffers gespeichert werden soll. Die Angabe erfolgt ohne %. Diese Variable kann verwendet werden, um den Maximalwert für eine Abfrageschleife zu bestimmen. In diesem Fall sollten Sie den Befehl Read-XmlNode mehrfach im eScript eintragen: zunächst nur zur Ermittlung des maximalen Index und dann in einer entsprechenden Schleife zum Auslesen der einzelnen gefundenen Werte.

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

-Path <String>

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

-ResultVariable <String>

Legt die Variable fest, in der das Ergebnis des Befehls gespeichert werden soll. Die Angabe erfolgt ohne %.

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

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

<CommonParameters>

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