Remove Send Port (BizTalk Server Sample)

The Remove Send Port sample demonstrates how to unenlist and remove one or more send ports.

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.

  • Unenlist those send ports.
  • Delete 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 RemoveSendPort.vbs. We recommend that RemoveSendPort.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\Remove Send Port\

File Inventory

The following table shows the files in this sample and describes their purpose.

File(s)Description
In the \VBScript folder:

RemoveSendPort.vbs

VBScript file that takes a parameter that specifies one or more send ports to unenlist and remove.

To Build and Initialize This Sample

The Remove Send Port sample consists of a single VBScript file that you not need to build or initialize.

To Run This Sample

Use the following procedure to run the Remove Send Port sample.

  1. In a command window, navigate to the following folder:

    <Samples Path>\Admin\WMI\Remove Receive Port\VBScript\

  2. Run the file RemoveSendPort.vbs using the cscript program, passing the following command-line argument:
    • <SendPortName>. The name of the send port(s) to remove. If the send port name contains spaces, enclose the name in quotes.

      For example:

      cscript RemoveSendPort.vbs "My Business Send Port"
      

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 RemoveSendPort.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.
Show: