« BTSReset with PowerShell | Main | FixEncoding Pipeline Component v1.0.0.1 »
Continuing with my series on managing BizTalk Server with PowerShell, here's a new script that deals with suspended messaging service instances:
# # declare our parameters: the action to take, and an optional # path to save messages to # param( [string] $action=$(throw 'need action'), [string] $path=$(if ($action -eq 'save') { throw 'need path' }) ) # # get all suspended messaging service instances, # both resumable and not-resumable # function bts-get-messaging-svc-instances() { get-wmiobject MSBTS_ServiceInstance ` -namespace 'root\MicrosoftBizTalkServer' ` -filter 'ServiceClass=4 and (ServiceStatus = 4 or ServiceStatus = 16)' } # # save the message associated to the # specified messaging Service Instance # function bts-save-message([string]$msgid) { $msg = get-wmiobject MSBTS_MessageInstance ` -namespace 'root\MicrosoftBizTalkServer' ` -filter "ServiceInstanceID = '$msgid'" $msg.psbase.invokemethod('SaveToFile', ($path)) "Message from ServiceInstanceID=$msgid saved." } # # main script # switch ( $action ) { 'list' { bts-get-messaging-svc-instances | fl InstanceId, ServiceName, SuspendTime, HostName, ServiceStatus, ErrorId, ErrorDescription } 'save' { bts-get-messaging-svc-instances | %{ bts-save-message($_.InstanceID) } } }
If you run it with the 'list' action, you can get a nicely formatted list with the more significant properties of any suspended messaging service instance:
PS E:\Projects\BizTalk\PSScripts> .\bts-get-suspended-msgs -action list InstanceId : {24FF0CAC-58F8-424C-BC49-6E1BD5045463} ServiceName : AttachmentRequestRP SuspendTime : 20060902091027.000000-300 HostName : BizTalkServerApplication ServiceStatus : 4 ErrorId : 0xc0c01680 ErrorDescription : The published message could not be routed because no subscri bers were found. This error occurs if the subscribing orches tration or send port has not been enlisted, or if some of th e message properties necessary for subscription evaluation h ave not been promoted. Please use the Biztalk Administration console to troubleshoot this failure. InstanceId : {0661221D-3C2F-4AD6-B952-099E02BD0E21} ServiceName : AttachmentRequestRP SuspendTime : 20060902091045.000000-300 HostName : BizTalkServerApplication ServiceStatus : 4 ErrorId : 0xc0c01680 ErrorDescription : The published message could not be routed because no subscri bers were found. This error occurs if the subscribing orches tration or send port has not been enlisted, or if some of th e message properties necessary for subscription evaluation h ave not been promoted. Please use the Biztalk Administration console to troubleshoot this failure.
Do notice the script filters out so that we only consider messaging service instances and not others like a suspended orchestration, you can however very easily tweak the script to show those as well as present a different set of properties for each instance.
You can also run the script with the 'save' action and provide a secondary 'path' argument to the script. In this case, the script will save any tracked messages associated with the suspended messaging service instances into the specified folder:
PS E:\Projects\BizTalk\PSScripts> .\bts-get-suspended-msgs -action save 'c:\temp \ctt' Message from ServiceInstanceID={24FF0CAC-58F8-424C-BC49-6E1BD5045463} saved. Message from ServiceInstanceID={0661221D-3C2F-4AD6-B952-099E02BD0E21} saved. Message from ServiceInstanceID={9E661EE6-4599-4458-B370-179220D66CF1} saved.
Enjoy!
Tomas Restrepo is a software developer located in Colombia, South America. His interests include .NET, Connected Systems, PowerShell and lately dynamic programming languages. More...
email: tomas@winterdom.com msn: tomasr@passport.com
Copyright © 2002-2008, Tomas Restrepo.
Powered by: newtelligence dasBlog 2.1.8139.823