PowerShell adapter

The BMC Atrium Orchestrator base adapter for Microsoft Windows PowerShell product is used to execute PowerShell commands on remote host computers running Microsoft Windows PowerShell. The Microsoft Windows PowerShell base adapter consists of an actor adapter only.

This adapter must be enabled on a Windows-based system.

The BMC Atrium Orchestrator base adapter for Microsoft Windows PowerShell does not utilize the xCmd utility if the target computer is the local host computer. The adapter does not use the xCmd utility in the following cases:

• When you specify an empty configuration and you do not specify a dynamic target in the adapter request
• When you do not specify a host in the <target> block of the adapter configuration or the <host> tag in the dynamic target request

If you specify 127.0.0.1 or the host name of the local computer, the adapter still uses the xCmd utility for executing PowerShell commands.

The actor adapter for Microsoft Windows PowerShell provides operations that use the PowerShell command-line interface to execute commands. The actor adapter for Microsoft Windows PowerShell supports the following command attributes:

• Multiple configuration nodes
• Dynamic targets
• FAT commands to enable platform independence--Command attributes:
  • timeout-secs
  • continue-on-failure
  • ignore-response
  • working- dir
  • os-id
  • os-version
• Command encryption
• Password encryption

The actor adapter for Microsoft Windows PowerShell does not support the following command attributes:

• command-dir
• is-special-character
• Proxy commands
• Verification of OS

Before executing a script file or a console file for working-dir, prepend ./ before the script file name.

Example:samplescript.ps1 must be executed as ./samplescript.ps1. 

The value for working-dir must not end with a backslash, however two backslashes are permitted.

Example:work-dir="c:\tempdir " or work-dir="c:\tempdir\\"

The following figure shows an XML template for the PowerShell adapter configuration.

XML template of the PowerShell adapter configuration

<config>
      <target></target>
      <user-name></user-name>
      <password encryption-type=""></password>
      <powershell-version></powershell-version>
      <powershell-consolefile></powershell-consolefile>
      <use-userprofile></use-userprofile>
      <script-file-path></script-file-path>
</config>
<config>
      <target></target>
      <user-name></user-name>
      <password encryption-type=""></password>
      <powershell-version></powershell-version>
      <powershell-consolefile></powershell-consolefile>
      <use-userprofile></use-userprofile>
      <script-file-path></script-file-path>
</config>