PowerShell Adapter

Properties   Configuration Settings  

Executes PowerShell scripts and returns the results.

Remarks

The PowerShell BizTalk Adapter is a BizTalk Server transmit adapter that will execute PowerShell scripts whenever BizTalk sends a message through it. This allows for easy creation of custom processing scripts for BizTalk messages that are completely integrated into your BizTalk solution.

Setting up the Adapter

To use the PowerShell BizTalk Adapter, it's necessary to do the following:

1. Create a new Send Port in your BizTalk application
2. Select the PowerShell BizTalk Adapter as the adapter to use in the port
3. Configure the Adapter settings with the following:
   • A name that identifies this send port
   • The PowerShell script to execute when a message is sent; this can be the script itself or the dot-source for an external script file
   • Optionally, to pass additional input data to the script, fill in the Variables property; this should be a list of 'name=value' pairs, one per line, and each one will be visible in the PowerShell script as a variable called $name

Accessing the BizTalk Message

Detailed information about accessing BizTalk message properties can be found under the Script property.

Diagnosing Scripts

The Adapter provides an easy way for scripts to generate diagnostics data that can be used to troubleshoot their behavior, by providing ways for the scripts to write diagnostic messages directly to the Adapter log.

This is exposed to the script through the Write-Debug, Write-Warning and Write-Verbose cmdlets, or as an alternative, by calling the corresponding functions in $host.UI.

Executing Scripts on Remote Machines

Detailed information on remote execution can be found under the Host property.