Sie können Objekte von der API des PowerShell-Plug-Ins verwenden, um von Windows PowerShell zurückgegebene Ergebnisse zu verarbeiten.

Sie können die Methoden aus der Klasse PowerShellInvocationResult verwenden, um Informationen zum ausgeführten Skript zu erhalten.

Methode

Beschreibung

getErrors()

Gibt eine Liste der vom PowerShell-Modul während des Skriptabrufs gemeldeten Fehler zurück.

getInvocationState()

Status des Skripts. Die möglichen Werte sind Completed oder Failed.

getHostOutput()

Ausgabe des Skripts, wie es in der PowerShell-Konsole angezeigt wird.

getResults()

Vom PowerShell-Modul zurückgegebene Objekte. Das zurückgegebene Objekt ist vom Typ PowershellRemotePSObject.

PowershellRemotePSObject ist eine Remote-Darstellung von Objekten, die vom PowerShell-Modul zurückgegeben wurden. PowershellRemotePSObject enthält die XML-Serialisierung des Ergebnisses, die durch Aufruf der Methode getXml() aufgerufen werden.

Das PowerShell-Plug-In bietet auch ein Objektmodell, das das XML-Ergebnis umhüllt und einfacheren Zugriff auf bestimmte Objekteigenschaften gewährt. Die Methode getRootObject() gewährt Zugriff auf das Objektmodell. Im Allgemeinen ordnet die Methode getRootObject() die PowerShell-Typen den in Orchestrator verfügbaren Typen anhand der folgenden Regeln zu.

  • Wenn das zurückgegebene Objekt ein einfacher PowerShell-Typ ist, wird es dem entsprechenden einfachen Orchestrator-Typ zugeordnet.

  • Wenn das zurückgegebene Objekt den Typ collection hat, wird das Objekt als ArrayList dargestellt.

  • Wenn das zurückgegebene Objekt den Typ dictionary hat, wird das Objekt als Hashtable dargestellt.

  • Wenn das zurückgegebene Objekt den Typ complex hat, wird das Objekt als PSObject dargestellt.