Remove-AzureBizTalkBridge

 

Important

Microsoft Azure BizTalk Services (MABS) is being retired, and replaced with Azure Logic Apps. If you currently use MABS, then Move from BizTalk Services to Logic Appsprovides some guidance on moving your integration solutions to Logic Apps.

If you're brand new to Logic Apps, then we suggest getting started here:

• What are logic apps

• Create your first logic app, or quickly get started using a pre-built template

• View all the available connectors you can use in your logic apps

The Remove-AzureBizTalkBridge deletes a bridge deployed at a specific BizTalk Services endpoint. If you have a bridge deployed at the relative address /A/B/C, and you perform a delete operation on /A, you get an error. Similarly, if you perform the delete operation at a relative address that does not exist, you get an error. You must perform the delete operation only at the complete relative address of an existing bridge.

Syntax

Remove-AzureBizTalkBridge –AcsNamespace <AcsNamespace> -IssuerName <IssuerName> -IssuerKey <IssuerKey> –DeploymentUri <DeploymentUri> -BridgePath <BridgePath> [-NoPrompt] [<CommonParameters>]

Parameters

Parameter	Requirement	Description
-AcsNamespace <AcsNamespace>	Required	The Access Control namespace associated with BizTalk Services.
-IssuerName <IssuerName>	Required	The Access Control issuer name. Specifying incorrect Access Control credentials results in an authentication error.
-IssuerKey <IssuerKey>	Required	The Access Control issuer key. Specifying incorrect Access Control credentials results in an authentication error.
-DeploymentUri <DeploymentUri>	Required	The deployment URI for BizTalk Services. For example, https://myDeploymentUri.biztalk.windows.net/default/. Specifying an incorrect URL results in an ObjectNotFound error.
-BridgePath <BridgePath>	Required	The complete relative path to the bridge that needs to be deleted. If you provide a path that has one or more bridges deployed under it, you get an InvalidOperation error. Also, if you provide a path where no bridge is deployed, you get an ObjectNotFound error.
[-NoPrompt]	Optional	If included, you are not prompted for a confirmation before the bridge is deleted.
[CommonParameters]	Optional	Can be used with any cmdlet and are implemented by Windows PowerShell. Options include: -Verbose -Debug -ErrorActions -ErrorVariable -WarningAction -WarningVariable -OutBuffer -OutVariable get-help about_commonparameters provides detailed information about these common parameters. about_CommonParameters is also a good resource.

Examples

• Successfully delete a bridge

  Remove-AzureBizTalkBridge –AcsNamespace myACS -IssuerName owner -IssuerKey <issuer key> –DeploymentUri https://myDeploymentUri.biztalk.windows.net/default -BridgePath myBridge

  Output

  Successfully deleted bridge https://myDeploymentUri.biztalk.windows.net/default/myBridge

• Error when bridge is not found

  Remove-AzureBizTalkBridge –AcsNamespace myACS -IssuerName owner -IssuerKey <issuer key> –DeploymentUri https://myDeploymentUri.biztalk.windows.net/default -BridgePath myIncorrectBridge

  Output

  ERROR: Bridge not found. Could not find bridge https://myDeploymentUri.biztalk.Windows.net/default/myIncorrectBridge

See Also

PowerShell CmdLets to manage the BizTalk Service