Share via


New-UMIPGateway

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-07-12

O cmdlet New-UMIPGateway cria um novo gateway IP de UM (Unificação de Mensagens). O gateway IP de UM é usado para conectar servidores de Unificação de Mensagens a um gateway IP ou a um PBX IP habilitado para SIP.

Sintaxe

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

Descrição detalhada

O cmdlet New-UMIPGateway cria uma novo gateway IP de UM. O gateway IP de UM tem escopo organizacional e faz referência a um único gateway IP físico. O novo gateway IP de UM criado é usado para estabelecer uma conexão com um gateway IP ou um PBX IP habilitado para SIP.

Para executar o cmdlet New-UMIPGateway, você deve usar uma conta à qual esteja delegada a função de Administrador da Organização do Exchange.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Address

Necessário(s)

Microsoft.Exchange.Data.UMSmartHost

Este parâmetro especifica o endereço IP que está configurado no gateway IP ou PBX IP habilitado para SIP.

Name

Necessário(s)

System.String

Esse parâmetro especifica o nome para exibição do gateway IP de UM. O nome do novo gateway IP de UM pode conter até 64 caracteres.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro faz com que o comando pause o processamento e exige que o administrador confirme o que o comando fará antes que o processamento continue. O valor padrão é $true.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Esse parâmetro especifica o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteraçao de configuraçao no serviço de diretório Active Directory.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Esse parâmetro especifica que o cmdlet usará a configuração de um objeto existente, quando ele for fornecido a esse parâmetro, para criar uma cópia idêntica do objeto em um local ou de destino

UMDialPlan

Opcional

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Esse parâmetro especifica o plano de discagem de UM a ser associado ao gateway IP de UM.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Este parâmetro instrui o comando a simular as ações que ele executaria no objeto. Ao usar o parâmetro WhatIf, o administrador poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é $true.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo de código cria um novo gateway IP de UM chamado MyUMIPGateway que habilitará um servidor de Unificação de Mensagens para começar a aceitar chamadas de um gateway IP que tenha um endereço IP de 10.10.10.1.

O segundo exemplo de código cria um novo gateway IP de UM chamado MyUMIPGateway que habilitará um servidor de Unificação de Mensagens para começar a aceitar chamadas de um gateway IP que tenha um FQDN de MyUMIPGateway.contoso.com.

New-UMIPGateway -Name MyUMIPGateway -Address 10.10.10.1

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