Applies to: Exchange Server 2007
Topic Last Modified: 2007-08-08

The Get-UMIPGateway cmdlet returns a list of properties and values for a specified UM IP gateway or for a list of UM IP gateways.

Syntax

Get-UMIPGateway [-Identity <UMIPGatewayIdParameter>] [-DomainController <Fqdn>] [-IncludeSimulator <SwitchParameter>]

Parameters

Parameter Required Type Description

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.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

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

IncludeSimulator

Optional

System.Management.Automation.SwitchParameter

This parameter retrieves the simulator of the UM IP gateway that is being viewed. A simulator allows a client to connect to the Unified Messaging server. This connection is typically used with the Exchange UM Test Phone application.

Detailed Description

The Get-UMIPGateway cmdlet displays the properties and values for a specified UM IP gateway, such as the display name, the IP address, status, and outcall settings. If no parameter is specified, all UM IP gateways in the Active Directory forest will be returned.

To run the Get-UMIPGateway cmdlet, the account you use must be delegated the Exchange View-Only 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 example displays a formatted list of all the UM IP gateways in the Active Directory forest.

The second example displays the properties for a UM IP gateway named MyUMIPGateway.

The third example displays all the UM IP gateways including IP gateway simulators in the Active Directory forest.

Copy Code
Get-UMIPGateway |format-list

Get-UMIPGateway -Identity MyUMIPGateway

Get-UMIPGateway -IncludeSimulator $true