Matt's Musings - All Comments

re: MSDN Magazine article on building custom activities for workflows

Shane — Fri, 01 Aug 2008 10:54:39 GMT

Thanks for posting - just found it over at MSDN.

re: Understanding the FactHandle in a FactRetriever

Glenn Kees — Thu, 31 Jul 2008 16:42:21 GMT

Awesome! This is the only place I have come across such info...

Thanks,

Glenn

re: PowerShell for BizTalk Server

matt-milner — Wed, 30 Jul 2008 15:02:09 GMT

Moshe,

Glad it worked and that I could help. It wasn't a bother at all, that's why I posted this stuff and this is good conversation.

On using the Enums, you are right that the text value would be better. In PowerShell, the way you do this is to wrap the name in quotes:

$null = $app.Stop("StopAll")

Then Powershell will try to convert that string to an enum value. As long as the string you are using matches one of the allowed values, it works like a charm.

Thank for pointing that out, it is a nice improvement on the script for readability.

Matt

re: PowerShell for BizTalk Server

moshe ro — Wed, 30 Jul 2008 09:09:49 GMT

Hi Matt.

I'm tring to implement the start function

I tried to figure where did u get the "public enum " values ,but I didn't find .

I found in msdn.microsoft.com/.../microsoft.biztalk.applicationdeployment.applicationstopoption.aspx that "This enumeration supports the BizTalk Server 2006 infrastructure and is not intended to be used directly from your code."

My qeustion is ,How can I use the member name I.S.O the enum values ?

I tried to run it like this way :

$null = $app.Stop(StopAll) .

But I got :

Missing `)` in Method call .

re: PowerShell for BizTalk Server

moshe ro — Wed, 30 Jul 2008 06:23:30 GMT

Hi Matt.

I set the value to 15 (as you recommended) and it solved the problem :-) .

Your implementation save me the amounr of code that involves the need to unenlist each orch within a given dll ,and the dependency calculation of each orchs (inside the given dll).

I want to thank you ,and apologize for bothering you and your blog.

thanx and regards

moshe ro

re: PowerShell for BizTalk Server

matt-milner — Tue, 29 Jul 2008 19:54:40 GMT

Moshe,

that value comes from the enum ApplicationStopOption

public enum ApplicationStopOption

{

DisableAllReceiveLocations = 8,

StopAll = 0x3f,

StopReferencedApplications = 0x20,

UndeployAllPolicies = 0x10,

UnenlistAllOrchestrations = 1,

UnenlistAllSendPortGroups = 4,

UnenlistAllSendPorts = 2

}

this enum supports the "flags" option so it can bitwised together. You might want to try a value of 15 (0x0f) to stop everything but policies and referenced applications. This may be part of your problem.

The docs for the enum are at:

technet.microsoft.com/.../microsoft.biztalk.explorerom.applicationstopoption.aspx

Hope this helps.

Matt

re: PowerShell for BizTalk Server

moshe ro — Tue, 29 Jul 2008 19:24:29 GMT

Hi Matt ,

Thanx for your patience .

I would appreciate ,if you just explain what is the "63"

from $null = $app.Stop(63) stands for ? ,and what is the

source of getting this value(63)

re: PowerShell for BizTalk Server

matt-milner — Mon, 28 Jul 2008 18:07:45 GMT

Moshe,

I don't see anything wrong with the script. When I run with dependencies on my machine, I get that error regardless of whether I use the admin console or the script / API. Keep in mind that the admin console does let you select (on another tab) referencing applications to stop when you stop one application. If you have that set, it might be trying to stop both in the console, but not in the script.

I'm not sure how your orchestrations reference each other (do they use a Call or Start orchestration) but that might have something to do with it as well. In my tests I just use dependencies of artifacts that are found in the admin console; depending on a send port in another app for instance.

Have you tried writing the script that unenlists the depending orchestrations first, then stopping your application? That should definitely work.

I'm not sure what other help I can give as I can't reproduce your problem on my end. Sorry.

Matt

re: PowerShell for BizTalk Server

moshe ro — Mon, 28 Jul 2008 14:01:25 GMT

Hi Matt,

After I did a full stop in the admin console to my application ,the other Orchs (EAI_ATGW*) status in my other application is still started.

Is it possible that you copy the example code that I wrote on 23/7 ,and run it ? (perhaps something is missing in the script)

Double Click on the .sln file doesn't open Visual Studio on Vista

CodeMetropolis — Sun, 27 Jul 2008 07:02:20 GMT

Double Click on the .sln file doesn't open Visual Studio on Vista

re: PowerShell for BizTalk Server

matt-milner — Thu, 24 Jul 2008 15:58:59 GMT

Moshe,

After you do the full stop in the admin console, what is the state of the orchestrations in your other application that depends on the orchestration in the application you are stopping.

EAI_ATGW_Orchs.Async_TGW_Main_Orch, EAI_ATGW_Orchs

AND

EAI_ATGW_Orchs.Async_TGW_Transportation_Orch, EAI_ATGW_Orchs

Are they stopped or unenlisted? Perhaps the admin console is doing some work behind the scenes for you that you'll need to do manually with the object model (i.e. stopping or unenlisting those orchestrations that depend on the one you are unenlisting).

As far as I know, choosing a specific application by name will not get more than one application, and as you can see from the script, it does not iterate over the results. So any dependencies are baked into using explorer object model to manage applications. In other words, I think you'd see this in a C# application as well.

re: PowerShell for BizTalk Server

moshe ro — Thu, 24 Jul 2008 15:39:00 GMT

Hi,

I don't think this is the case

I have checked it:

I verify that all the orchs are started .

Then I made a stop (Full stop) to my specific application (using admin console).

This stop (using admin console) worked successfull

without errors

re: PowerShell for BizTalk Server

matt-milner — Wed, 23 Jul 2008 19:22:27 GMT

Moshe,

It looks as if you might have case where an orchestration in another application has a dependency on an orchestration in your current application. If that is the case, then use the function to unenlist the relying orchestration, then stop your application. A test for this would be to make sure the relying orchestration is started and try to do a stop of your application in the admin console. You should get the same error.

re: PowerShell for BizTalk Server

moshe ro — Wed, 23 Jul 2008 19:10:59 GMT

Hi,

you were write ,I run the script in 32 bit version of PowerShell ,and then it succeded to run .

However ,when I tried to implement your code ,I got an answer that it failed .

from the failure ,I understand that it tried to stop all the application ,while I tried to stop only spedific application (EAI_NumberManagement).

This is the example :

**********************

[System.Reflection.Assembly]::LoadFrom("C:\Program Files (x86)\Microsoft BizTalk Server 2006\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll")

function Get-BTSConnectionString

{

$group = Get-WmiObject MSBTS_GroupSetting -n root\MicrosoftBizTalkServer

$dbName = $group.MgmtDBName

$server = $group.MgmtDBServerName

[System.String]::Concat("server=", $server, ";database=", $dbName, ";Integrated Security=SSPI")

}

function StopBTSApplication

{

$appName="EAI_NumberManagement"

$exp = New-Object Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer

$exp.ConnectionString = Get-BTSConnectionString

$app = $exp.Applications[$appName]

if($app -eq $null)

{

Write-Host "Application " $appName " not found" -fore Red

}

else

{

if($app.Status -ne 2)

{

#full stop of application

$null = $app.Stop(63)

$null = $exp.SaveChanges()

Write-Host "Stopped application: " $appName

}

StopBTSApplication

******************************

The output was:

Exception calling "SaveChanges" with "0" argument(s): "Could not stop orchestration 'EAI_AQRetry_Orchs.ArmAQRetry_Orch,

EAI_AQRetry_Orchs, Version=1.0.0.0, Culture=neutral, PublicKeyToken=267fe1f0f0549c16'. Orchestration(s) 'EAI_ATGW_Orchs

.Async_TGW_Main_Orch : EAI_ATGW_Orchs, Version=1.0.0.0, Culture=neutral, PublicKeyToken=267fe1f0f0549c16', 'EAI_ATGW_Or

chs.Async_TGW_Transportation_Orch : EAI_ATGW_Orchs, Version=1.0.0.0, Culture=neutral, PublicKeyToken=267fe1f0f0549c16'

is(are) started which depend(s) upon this orchestration."

At C:\temp\stop_app.ps1:28 char:28

+ $null = $exp.SaveChanges( <<<< )

re: PowerShell for BizTalk Server

Peter Golconda — Mon, 21 Jul 2008 23:22:56 GMT

I could implement it and create an admin app (.net) for my company so that any support person (without much biztalk experience) will be able to support. Thanks for the code.