Project Description

A Provider for powershell that allows to administrate your BizTalk Server.

The BizTalk PowerShell Provider is a common project between the community "http://www.soa-factory.org" and Logica Management Consulting.

The BizTalkFactory PowerShell Provider is a PowerShell Snap-In for BizTalk Server 2006 R2 and BizTalk Server 2009 that allows developers and administrators to easily automate routine and complex BizTalk administration tasks such as deploying applications, and managing configuration and run-time data using Windows PowerShell. Administrators can further increase productivity by leveraging the many cmdlets included with BizTalkFactory PowerShell Provider.

The project is divided into two components :

• The BizTalkFactory Management Automation Layer
• The BizTalkFactory PowerShell Provider

BizTalkFactory Management Automation (SDK)

The BizTalk Factory Management Automation assembly is a complete hierarchical object model over BizTalk artifacts. It enables you to perform various tasks on BizTalk groups, including administrating and deploying BizTalk solutions. Its goal is to provide a façade over various underlying technologies in a single unified object library. It currently wraps Microsoft.BizTalk.ExplorerOM, Microsoft.BizTalk.ApplicationDeployment, as well as BizTalk WMI objects in order to perform its processing.

The BizTalk Factory Management Automation is designed to be a supporting library for the BizTalk PowerShell Provider, but it can be used as a standalone project that does not incur any dependencies on PowerShell. This makes it an ideal candidate for use in your own programming projects around administrating and manipulating BizTalk artifacts.

BizTalkFactory PowerShell Provider

The BizTalk PowerShell Provider is designed to give you access to most BizTalk artifacts by simply "navigating" through a virtual tree hierarchy. At each node in the hierarchy you can find an object that you can use to perform various administrative functions, such as starting an application, creating a new host instance, exporting an application to a Windows Installer MSI package, etc.

You can also perform several operations simultaneously by taking advantage of the PowerShell pipeline. For instance, you can stop all applications of a given BizTalk group by simply issuing the familiar Get-ChildItem command and piping the result to the Stop-Application CmdLet.

Project Releases

BizTalk Factory PowerShell Provider
http://psbiztalk.codeplex.com/Release/ProjectReleases.aspx#ReleaseFiles
Status: Beta 1.0.
Please, refer to the Releases tab for download instructions.
Please, refer to the Getting Started guide for proper installation and usage notes.

BizTalk Factory Management Automation
Status: Beta 1.0
Warning: This release is part of the BizTalk Factory PowerShell Provider and replaces the previously downloadable assembly.
Please, refer to the Releases tab for download instructions.

Getting Started

In order to make use of the BizTalk PowerShell Provider, please execute the following commands from within the PowerShell console. You can also put these commands into your profile or export the shell afterwards.

    add-PSSnapIn BizTalkFactory.PowerShell.Extensions
    
    Function Biztalk: { Set-Location Biztalk:\ }
    
    Set-Alias Enlist-SendPort Stop-SendPort

A Getting Started Guide is available for download. Please, refer to this document for latest features and known issues.

Available CmdLets

The following cmdlets are available in this provider:

• Add-ApplicationReference
• Remove-ApplicationReference

• Add-ApplicationResource

• Set-DefaultApplication

• Start-Application
• Stop-Application

• Start-HostInstance
• Stop-HostInstance
• Reset-HostInstance

• Start-Orchestration
• Stop-Orchestration
• Enlist-Orchestration
• Unenlist-Orchestration

• Disable-ReceiveLocation
• Enable-ReceiveLocation

• Start-SendPort
• Stop-SendPort
• Enlist-SendPort
• Unenlist-SendPort

• Start-SendPortGroup
• Stop-SendPortGroup
• Enlist-SendPortGroup
• Unenlist-SendPortGroup

• Import-Application
• Import-Bindings

• Export-Application
• Export-Bindings
• Export-Policy

You can also use the New-Item and Remove-Item builtin CmdLet to create and remove the following objects:

• Application
• Schema
• SendPort
• SendPortGroup
• Host
• HostInstance
• Orchestration
• Pipeline
• ReceiveLocation
• ReceivePort
• Resource

Most artifacts also support setting properties via the Set-ItemProperty CmdLet.

How to Contribute

You can contribute in many ways to this project. We ask that in order to join the project, you provide a first contribution, either to the documentation or the source code of the project. Please, keep in touch with us first so that we can coordonate who is doing what.

You may have a look to the following "Planned Features" section below for a comprehensive list of further planned changes. These are actual hints as to what contributions we might expect. Please, do not hesitate to provide your own ideas for a contribution if it does not already appears in this list.

Planned Features

To be defined.

Contributors

Randal van Splunteren

Randal works as a consultant in the Netherlands. He focuses on Microsoft .Net technology especially on Microsoft BizTalk Server. He has customer experience with all BizTalk versions (2000, 2002, 2004, 2006, 2006 R2). On his blog he tries to write useful stuff about .Net and BizTalk. Certifications: MCAD, MCTS: BizTalk Server 2004, BizTalk Server 2006 & BizTalk Server 2006 R2.

Michel Hubert

Michel works as an information systems architect in France. As an Microsoft BizTalk MVP (Most Valuable Professional), Michel maintains a blog where he writes about various bits and topics about Microsoft.

Maxime Labelle

Maxime works as a consultant in France. He has been developing applications using Microsoft tools and languages for far too long... Among specialists circles, rumor has it that Maxime loves to tackle obscure problems related to encodings and character sets. He will try and maintain a technical blog on BizTalk and various Microsoft-related technologies.