Start Send Port (BizTalk Server Sample)
The Start Send Port sample demonstrates how to start a send port and optionally set the Primary Transport Address when using the FILE adapter.
The Visual Basic Scripting Edition (VBScript) script in the script file that constitutes this sample shows how to perform the following operations using the BizTalk Server WMI provider:
- Given a send port name, query for a list of matching send ports.
Note Generally, there will only be one send port that matches a given name.
- Set the Primary Transport Address for those send ports (relative to the installation path).
- Start those send ports.
- Handle any errors such that meaningful information is returned to the user.
Note For important information about all samples in this SDK, see Samples.
To download the updated BizTalk Server 2004 SDK, go to http://go.microsoft.com/fwlink/?LinkId=24723.
Important There is a potentially exploitable SQL Injection security vulnerability in StartSendPort.vbs. We recommend that StartSendPort.vbs be removed from a production environment or secured in a share with administrative access control lists (ACLs).
Location in SDK
<Samples Path>\Admin\WMI\Start Send Port\
File Inventory
The following table shows the files in this sample and describes their purpose.
| File(s) | Description |
|---|---|
| In the \VBScript folder:
StartSendPort.vbs | VBScript file that takes parameters that specify a send port to start, and optionally, a new value for the Primary Transport Address associated with that port. |
To Build and Initialize This Sample
The Start Send Port sample consists of a single VBScript file that you do not need to build or initialize.
To Run This Sample
Use the following procedure to run the Start Send Port sample.
- In a command window, navigate to the following folder:
<Samples Path>\Admin\ExplorerOM\Start Send Port\VBScript\
- Run the file StartSendPort.vbs using the cscript program, passing the following command-line arguments, the second of which is optional:
- <SendPortName>. The name of the send port to start. If the send port name contains spaces, enclose the name in quotes.
- <PrimaryTransportAddress>. The Primary Transport Address, relative to the product installation location, that you can change by specifying this argument. If the primary adapter address contains spaces, enclose the name in quotes.
For example:
cscript StartSendPort.vbs "My Business Send Port" SDK\Samples\HelloWorld\Out\%MessageID%.xml
Remarks
All tasks that you can perform in the BizTalk Server Administration console can also be performed by using script that accesses the Windows WMI object model.
The script file StartSendPort.vbs contains detailed comments with further explanation about the operations that it performs. For more information, see Windows Management Instrumentation at http://go.microsoft.com/fwlink/?LinkId=21102.
See Also
Admin\WMI (BizTalk Server Samples Folder)
To download updated BizTalk Server 2004 Help from www.microsoft.com, go to http://go.microsoft.com/fwlink/?linkid=20616.Copyright © 2004 Microsoft Corporation.All rights reserved.