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

The New-UMIPGateway cmdlet creates a new Unified Messaging (UM) IP gateway. A UM IP gateway is used to connect Unified Messaging servers to an IP gateway or a Session Initiation Protocol (SIP)-enabled IP PBX.

Syntax

New-UMIPGateway -Name <String> -Address <UMSmartHost> [-DomainController <Fqdn>] [-TemplateInstance <PSObject>] [-UMDialPlan <UMDialPlanIdParameter>]

Parameters

Parameter Required Type Description

Address

Required

Microsoft.Exchange.Data.UMSmartHost

This parameter specifies the IP address that is configured on the IP gateway or SIP-enabled IP PBX.

Name

Required

System.String

This parameter specifies the display name for the UM IP gateway. The name for the new UM IP gateway can contain up to 64 characters.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

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

TemplateInstance

Optional

System.Management.Automation.PSObject

When an existing object is supplied to this parameter, the cmdlet will use the configuration of that object to create an identical copy of the object on a local or target server.

UMDialPlan

Optional

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

This parameter specifies the UM dial plan to be associated with the UM IP gateway.

Detailed Description

The New-UMIPGateway cmdlet creates a new UM IP gateway. A UM IP gateway has organization-wide scope and references a single physical IP gateway. The new UM IP gateway that is created is used to establish a connection to an IP gateway or a SIP-enabled IP PBX.

To run the New-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

The first code example creates a new UM IP gateway named MyUMIPGateway that will enable a Unified Messaging server to start accepting calls from an IP gateway that has an IP address of 10.10.10.1.

The second code example creates a new UM IP gateway named MyUMIPGateway that will enable a Unified Messaging server to start accepting calls from an IP gateway that has an FQDN of MyUMIPGateway.contoso.com.

Copy Code
New-UMIPGateway -Name MyUMIPGateway -Address 10.10.10.1

New-UMIPGateway -Name MyUMIPGateway -Address "MyUMIPGateway.contoso.com"