Applies to: Exchange Server 2007
Topic Last Modified: 2007-07-12

The Remove-UMIPGateway cmdlet deletes a Unified Messaging (UM) IP gateway.

Syntax

Remove-UMIPGateway -Identity <UMIPGatewayIdParameter> [-DomainController <Fqdn>]

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

This parameter specifies the identifier for the UM IP gateway that is being deleted. This parameter specifies the directory object ID for the UM IP gateway.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter on the cmdlet.

Detailed Description

The Remove-UMIPGateway cmdlet deletes a specified UM IP gateway. After the UM IP gateway is deleted, Unified Messaging servers will no longer accept new call requests from the IP gateway. The Remove-UMIPGateway cmdlet should be run only by an administrator who fully understands the implications of disabling communication with a Session Initiation Protocol (SIP)-enabled IP PBX or IP gateway.

To run the Remove-UMIPGateway cmdlet, the account you use must be delegated the following:

  • Exchange Organization Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Input Types

Return Types

Errors

Error Description

 

 

Exceptions

Exceptions Description

 

 

Example

This example deletes a UM IP gateway named MyUMIPGateway.

Copy Code
Remove-UMIPGateway -Identity MyUMIPGateway