Você pode usar os objetos da API do plug-in PowerShell para trabalhar com os resultados que o Windows PowerShell retorna.

Você pode usar os métodos da classe PowerShellInvocationResult para recuperar as informações sobre um script que você executa.

Método

Descrição

getErrors()

Retorna uma lista de erros relatados pelo mecanismo do PowerShell durante a invocação de script.

getInvocationState()

Status do script. Os valores possíveis são Completed ou Failed.

getHostOutput()

Saída do script conforme exibida no console do PowerShell.

getResults()

Objetos retornados pelo mecanismo do PowerShell. O objeto retornado é do tipo PowershellRemotePSObject.

PowershellRemotePSObject é uma representação remota de objetos retornados pelo mecanismo do PowerShell. PowershellRemotePSObject contém a serialização de XML do resultado que pode ser acessado chamando o método getXml().

O plug-in PowerShell também fornece um modelo de objeto que encapsula o resultado XML e fornece acesso fácil às propriedades de objeto específicas. O método getRootObject() fornece acesso ao modelo de objeto. Em geral, o método getRootObject() mapeia os tipos do PowerShell para os tipos disponíveis no Orchestrator, usando as regras a seguir.

  • Se o objeto retornado for de um tipo primitivo do PowerShell, o objeto será mapeado para o tipo primitivo correspondente do Orchestrator.

  • Se o objeto retornado for do tipo collection, o objeto será representado como ArrayList.

  • Se o objeto retornado for do tipo dictionary, o objeto será representado como Hashtable.

  • Se o objeto retornado for do tipo complex, o objeto será representado como PSObject.