Você pode recortar, colar e editar os exemplos de JavaScript para escrever scripts para tarefas comuns do PowerShell.

Para obter mais informações sobre scripts, consulte o Guia do desenvolvedor do Automation Orchestrator.

Executar um script do PowerShell por meio da API

Você pode usar o JavaScript para executar um script do PowerShell por meio da API do plug-in.

Este script de exemplo realiza as ações a seguir.
  • Abre uma sessão para um host PowerShell.
  • Fornece um script para execução.
  • Verifica os resultados de invocação.
  • Encerra a sessão.
var sess;
try {
     //Open session to PowerShell host
     var sess = host.openSession()
     //Set executed script
     var result = sess.invokeScript('dir')

     //Check for errors
     if (result.invocationState == 'Failed'){
          throw "PowerShellInvocationError: Errors found while executing script \n" + result.getErrors();
     }
     //Show result
     System.log( result.getHostOutput() );
} catch (ex){
     System.error (ex)
} finally {
     if (sess) {
     //Close session
     host.closeSession( sess.getSessionId() );
     }
}

Trabalhar com o resultado

Você pode usar o JavaScript para trabalhar com o resultado de uma execução de script do PowerShell.

Este script de exemplo realiza as ações a seguir.
  • Verifica o estado da invocação.
  • Extrai um valor do resultado.
  • Verifica o tipo de RemotePSObject.
var sess = host.openSession()
sess.addCommandFromString("dir " + directory)
var invResult = sess.invokePipeline();
//Show result
System.log( invResult.getHostOutput() );

//Check for errors
if (invResult.invocationState == 'Failed'){
System.error(invResult.getErrors());
     } else {
     //Get PowerShellRemotePSObject
     var psObject = invResult.getResults();
     var directories = psObject.getRootObject();

     var isList = directories instanceof Array
     if ( isList ){
          for (idx in directories){
               var item = directories[idx];
               if ( item.instanceOf('System.IO.FileInfo') ){//Check type of object
                    System.log( item.getProperty('FullName') );//Extract value from result
               }
          }
     } else {
               System.log( directories.getProperty('FullName') );//Extract value from result
     }
}

host.closeSession( sess.getSessionId());

Conectar-se com credenciais personalizadas

Você pode usar o JavaScript para se conectar a um host PowerShell com credenciais personalizadas.

var sess;
try {
     sess = host.openSessionAs(userName, password);

     var invResult = sess.invokeScript('$env:username');

     //Check for errors
     if (invResult.invocationState == 'Failed'){
               System.error(invResult.getErrors());
     } else {
               //Show result
               System.log( invResult.getHostOutput() );
     }
} catch (ex){
     System.error (ex)
} finally {
     if (sess) {
                host.closeSession( sess.getSessionId());
     }
}