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 |
|