Set-UMIPGateway
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Set-UMIPGateway para modificar as definições de configuração de um gateway IP da UM (Unificação de Mensagens) único ou para retornar uma lista de definições de configuração que possam ser modificadas em um gateway IP da UM especificado.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Set-UMIPGateway
[-Identity] <UMIPGatewayIdParameter>
[-Address <UMSmartHost>]
[-Confirm]
[-DelayedSourcePartyInfoEnabled <Boolean>]
[-DomainController <Fqdn>]
[-ForceUpgrade]
[-IPAddressFamily <IPAddressFamily>]
[-MessageWaitingIndicatorAllowed <Boolean>]
[-Name <String>]
[-OutcallsAllowed <Boolean>]
[-Port <Int32>]
[-Simulator <Boolean>]
[-Status <GatewayStatus>]
[-WhatIf]
[<CommonParameters>]
Description
O cmdlet Set-UMIPGateway modifica as definições de configuração de um gateway IP da UM específico, por exemplo, o endereço IP para o gateway IP. Essas modificações incluem a permissão de chamadas de saída e o controle de comunicação com um IP PBX habilitado para SIP ou gateway IP.
É possível que as modificações nas definições do gateway de IP do UM possam interromper a comunicação entre os servidores da Caixa de Correio e o IP PBX ou o gateway IP ativado para SIP. As modificações em um gateway IP da UM devem ser realizadas apenas por um administrador que compreenda completamente as implicações de fazer alterações na configuração do gateway IP da UM.
Depois da conclusão da tarefa, os parâmetros e valores especificados são configurados no gateway IP da UM.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1
Este exemplo modifica o endereço IP do gateway IP da UM MyUMIPGateway.
Exemplo 2
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status Disabled -OutcallsAllowed $false
Este exemplo impede que um gateway IP da UM aceite chamadas de entrada e impede chamadas de saída.
Exemplo 3
Set-UMIPGateway -Identity MyUMIPGateway -Address fe80::39bd:88f7:6969:d223%11 -IPAddressFamily Any -Status Disabled -OutcallsAllowed $false
Este exemplo impede que o gateway IP da UM MyUMIPGateway aceite chamadas de entrada e chamadas de saída, define um endereço IPv6 e permite que o gateway IP da UM use endereços IPv4 e IPv6.
Exemplo 4
Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true
Este exemplo habilita o gateway IP da UM para funcionar como um simulador de gateway IP e pode ser usado com o cmdlet Test-UMConnectivity.
Parâmetros
-Address
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro Address especifica o endereço IP do FQDN (nome de domínio totalmente qualificado) configurado no gateway IP da UM ou no IP PBX habilitado para SIP. É necessário um FQDN se o plano de discagem da UM associado ao gateway IP da UM estiver operando em modo SIP seguro ou seguro. Se for utilizado um FQDN, verifique se o Sistema de Nomes de Domínio (DNS) está configurado corretamente.
Propriedades do parâmetro
| Tipo: | UMSmartHost |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DelayedSourcePartyInfoEnabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro DelayedSourcePartyInfoEnabled especifica se a Unificação de Mensagens deve atrasar o processo de aceitação de uma chamada de entrada do gateway VoIP, caso o SIP INVITE correspondente da chamada não tiver chamador e informações de desvio.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ForceUpgrade
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O comutador ForceUpgrade suprime a mensagem de confirmação que aparece se o objeto tiver sido criado numa versão anterior do Exchange. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro Identity especifica o identificador do gateway IP da UM que está sendo modificado. Esse parâmetro é o ID do objeto de diretório para o gateway IP da UM.
Propriedades do parâmetro
| Tipo: | UMIPGatewayIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IPAddressFamily
Aplicável: Exchange Server 2013, Exchange Server 2016
O parâmetro IPAddressFamily especifica a versão do Protocolo IP a utilizar. Os valores válidos são:
- IPv4Only: o gateway de IP do UM utiliza apenas IPv4 para comunicar. Este valor é a predefinição.
- IPv6Only: o gateway de IP de UM utiliza apenas IPv6.
- Qualquer: O IPv6 é utilizado primeiro. Se o IPv6 não estiver disponível, é utilizado IPV4.
Propriedades do parâmetro
| Tipo: | IPAddressFamily |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MessageWaitingIndicatorAllowed
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro MessageWaitingIndicatorAllowed especifica se o gateway IP da UM deve ser habilitado para permitir que mensagens SIP NOTIFY sejam enviadas aos usuários associados a um plano de discagem da UM e ao gateway IP da UM. O valor padrão é $true.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro Name especifica o nome para exibição do gateway IP da UM. Esse nome para exibição é limitado a 64 caracteres.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OutcallsAllowed
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro OutcallsAllowed especifica se este gateway IP da UM pode ser usado para chamadas de saída. Ele não controla transferências de chamada.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Port
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro Port especifica a porta IP em que o gateway IP ou IP PBX está escutando. Por padrão, é a porta 5060. O intervalo para esse parâmetro é de 0 a 65535.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Simulator
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro Simulator especifica o simulador usado para o gateway IP da UM que está sendo exibido. Um simulador permite que um cliente se conecte ao servidor de Caixa de Correio.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Status
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
O parâmetro Status especifica se o gateway IP da UM deve ser habilitado ou desabilitado. Os valores válidos são:
- Habilitado
- Desabilitado
- NoNewCalls
Propriedades do parâmetro
| Tipo: | GatewayStatus |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.