Vous pouvez utiliser les objets de l'API du plug-in PowerShell pour exploiter les résultats renvoyés par Windows PowerShell.
Vous pouvez utiliser les méthodes de la classe
PowerShellInvocationResult pour récupérer des informations à propos d'un script que vous exécutez.
| Méthode | Description |
|---|---|
| getErrors() | Renvoie la liste des erreurs signalées par le moteur PowerShell lors de l'appel du script. |
| getInvocationState() | État du script. Les valeurs possibles sont Completed ou Failed. |
| getHostOutput() | Sortie du script tel qu'elle s'affiche sur la console PowerShell. |
| getResults() | Objets renvoyés par le moteur PowerShell. L'objet renvoyé est de type PowershellRemotePSObject. |
PowershellRemotePSObject est une représentation distante des objets renvoyés par le moteur PowerShell. PowershellRemotePSObject contient une sérialisation XML du résultat qui peut être obtenue via l'appel de la méthode getXml().
Le plug-in
PowerShell fournit également un modèle d'objet qui encapsule le résultat XML et facilite l'accès à des propriétés spécifiques de l'objet. La méthode
getRootObject() confère un accès au modèle d'objet. En général, la méthode
getRootObject() mappe les types
PowerShell à ceux disponibles dans
Automation Orchestrator à l'aide des règles suivantes.
- Si l'objet renvoyé est d'un type PowerShell primitif, l'objet est mappé au type Orchestrator primitif correspondant.
- Si l'objet renvoyé est de type collection, l'objet est représenté en tant que ArrayList.
- Si l'objet renvoyé est de type dictionary, l'objet est représenté en tant que Hashtable.
- Si l'objet renvoyé est de type complex, l'objet est représenté en tant que PSObject.
