Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
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> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-TemplateInstance <PSObject>] [-UMDialPlan <UMDialPlanIdParameter>] [-WhatIf [<SwitchParameter>]]

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.

Confirm

Optional

System.Management.Automation.SwitchParameter

This parameter causes the command to pause processing and requires the administrator to acknowledge what the command will do before processing continues. The default value is $true.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

This parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service.

TemplateInstance

Optional

System.Management.Automation.PSObject

This parameter specifies that the cmdlet will use the configuration of an existing object, when it is supplied to this parameter, to create an identical copy of the object on a local or target

UMDialPlan

Optional

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

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

WhatIf

Optional

System.Management.Automation.SwitchParameter

This parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, the administrator can view what changes would occur without having to apply any of those changes. The default value is $true.

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 Exchange Organization Administrator role.

For more information about permissions, delegating roles, and the rights that are required to administer Microsoft 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"