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.
Syntax
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 configurações de gateway IP da UM possam interromper a comunicação entre os servidores de Caixa de Correio e o IP PBX habilitado para SIP ou gateway IP. 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 tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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.1Este 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 $falseEste 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 $falseEste 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 $trueEste 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
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 usado um FQDN, verifique se o DNS foi configurado corretamente.
| Type: | UMSmartHost |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Confirm
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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, cmdlets 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DelayedSourcePartyInfoEnabled
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DomainController
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.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-ForceUpgrade
O comutador ForceUpgrade suprime a mensagem de confirmação que aparece se o objeto foi criado em uma versão anterior do Exchange. Não é preciso especificar um valor com essa opção.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Identity
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.
| Type: | UMIPGatewayIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-IPAddressFamily
O parâmetro IPAddressFamily especifica se o gateway de IP de UM irá usar o Protocolo de Internet versão 4 (IPv4), IPv6 ou ambos, para se comunicar. Os valores válidos são:
- IPv4Only: o gateway de IP um só usará o IPv4 para se comunicar. Esse é o valor padrão.
- IPv6Only: o gateway de IP um só usará IPv6.
- Qualquer: o IPv6 será usado primeiro e, se necessário, ele retornará ao IPv4.
| Type: | IPAddressFamily |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016 |
-MessageWaitingIndicatorAllowed
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Name
O parâmetro Name especifica o nome para exibição do gateway IP da UM. Esse nome para exibição é limitado a 64 caracteres.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-OutcallsAllowed
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Port
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Simulator
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Status
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
| Type: | GatewayStatus |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-WhatIf
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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
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.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de