PowerShell Cmdlets for the BizTalk Adapter Service
Updated: November 27, 2015
Install and use the PowerShell cmdlets in BizTalk Adapter Service.
The BizTalk Adapter Service Runtime Server utilizes the cmdlet (command-let) ability of PowerShell to expose the LOB Relay and LOB Target entities. Using PowerShell, Administrators can manage the Runtime Service and these LOB entities.
Install Windows PowerShell 3.0.
Run the BizTalk Services setup file. See Install Azure BizTalk Services SDK.
The PowerShell cmdlets are automatically installed when the Tools option is selected during the setup. See Install Azure BizTalk Services SDK.
When the installation completes, the C:\Program Files\Windows Azure BizTalk Services Tools folder is created. This folder contains the BizTalk Adapter Service Runtime PowerShell module.
Select Windows PowerShell and Run as Administrator.
If User Account Control (UAC) is enabled, select Yes is prompted to proceed.
Type: import-module "C:\Program Files\Windows Azure BizTalk Services Tools\Microsoft.BizTalk.Adapter.Services.Powershell.dll"
To view the cmdlets, type: get-module. get-module displays the LOB Target and LOB Relay cmdlets supported by the BizTalk Adapter Service module.
The BizTalk Adapter Service Windows PowerShell module name is Microsoft.BizTalk.Adapter.Services.Powershell.dll. PowerShell scripts written using the Preview-version of the cmdlets may fail after upgrading.
When using import-module, modules exist only when the PowerShell command window is open; which is the current PowerShell session. When the PowerShell command window is closed, the session is closed and the module is removed.
PowerShell commands are not case-sensitive. As a result, focus on the correct syntax and spelling.
Cmdlet Parameter Shortcuts
By default, PowerShell allows any unique prefix for the cmdlet parameters. For example, -f, -fo and -for can all be used as a shortcut for the -ForceDelete parameter.
Install Runtime & Tools
Install on the same server. This option allows you to manage the BizTalk Adapter Service components in the cloud and use the PowerShell cmdlets (command-lets) on a central server.
The Developer portion of the Setup should be installed on a separate computer. The goal is to separate the development tasks from the runtime tasks.
Service Bus Namespace
When using the –Namespace parameter, always enter the Service Bus namespace.
get-help cmdletName -full
Use -full to get detailed information on the cmdlet, including examples and a description of each parameter.
The PowerShell about_ help topics are available in text format at C:\Windows\System32\WindowsPowerShell\v1.0\en-US.