Skip to content

Getting Started

Eivind Gussiås Løkseth edited this page Jun 18, 2020 · 1 revision

EXAMPLE 1 - Get started

Import-Module .\Publish-BiztalkBtdfApplication.psm1 
publish-btdfBiztalkApplication -biztalkMsi "C:\mybtdfMsi.msi" -installdir "C:\program files\mybtdfMsi"  -biztalkApplicationName DeploymentFramework.Samples.BasicMasterBindings -BtdfProductName "Deployment Framework for BizTalk - BasicMasterBindings" -backupDir c:\mybackupdir -importIntoBiztalkMgmtDb 1 -deployOptions @{"/p:VDIR_USERNAME"="contoso\adam";"/p:VDIR_USERPASS"="@5t7sd";"/p:ENV_SETTINGS"="""c:\program files\mybtdfMsi\Deployment\PortBindings.xml"""} 

This installs BTDF Biztalk application MSI C:\mybtdfMsi.msi, into install directory C:\program files\mybtdfMsi.

In this example, the custom deploy options, VDIR_USERNAME, VDIR_USERPASS and ENV_SETTINGS are the only deployment options required to deploy the app.

Note how the value of one of the BTDF deploy options, "/p:ENV_SETTINGS", is double quoted twice """c:\program files\mybtdfMsi\Deployment\PortBindings.xml""". Please make sure values with spaces are double quoted twice in the deploy, undeploy and install options hastable

EXAMPLE 2 - Whatif switch To run this script with the awesome whatif switch

publish-btdfBiztalkApplication -whatif

EXAMPLE 3 - Increase logging To run this script with increased log level for troublehooting, use the verbose switch

publish-btdfBiztalkApplication -verbose

EXAMPLE 4 - Customise Msbuild and BtsTask paths Customises the paths of msbuild and btstask

publish-btdfBiztalkApplication -msbuildPath "C:\Program Files (x86)\MSBuild\12.0\Bin\msbuild.exe" -btsTaskPath "$env:systemdrive\Program Files (x86)\Microsoft BizTalk Server 2013 R2\BtsTask.exe"

EXAMPLE 5 - Octopus Deploy

To better document this process, this example has been moved to a separate section of the wiki.

EXAMPLE 6 - To see more details, get help!

get-help publish-BTDFBiztalkApplication -full