Set-UMIPGateway
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-07-17
El cmdlet Set-UMIPGateway se utiliza para modificar las opciones de configuración de un único firewall IP de mensajería unificada (UM) o devolver una lista de opciones de configuración que pueden modificarse en un firewall IP de mensajería unificada dada.
Sintaxis
Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]
Set-UMIPGateway [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El cmdlet Set-UMIPGateway modifica las opciones de configuración de una puerta de enlace IP de mensajería unificada dada, por ejemplo, la dirección IP a la puerta de enlace IP. Estas modificaciones incluyen la aceptación de llamadas salientes y el control de comunicaciones mediante una IP PBX con el Protocolo de inicio de sesión (SIP) habilitado o una puerta de enlace IP.
Importante
Es posible que las modificaciones a las opciones de la puerta de enlace IP de mensajería unificada desestabilice la comunicación entre los servidores Mensajería unificada y la puerta de enlace IP con SIP habilitado o IP/PBX. Las modificaciones a un objeto de puerta de enlace IP de mensajería unificada sólo se pueden realizar por un administrador que comprenda al completo las implicaciones de realizar cambios de configuración en la puerta de enlace IP de mensajería unificada.
Para ejecutar el cmdlet Set-UMIPGateway, la cuenta que utilice debe tener delegada la función Administrador de la organización de Exchange.
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
Este parámetro especifica el identificador para el firewall de IP de mensajería unificada que está siendo modificado. Este parámetro es el ID del objeto de directorio para el firewall IP de mensajería unificada. |
Address |
Opcional |
Microsoft.Exchange.Data.UMSmartHost |
Este parámetro especifica la dirección IP que está configurada en la puerta de enlace IP o en una IP/PBX/central de conmutación (PBX) habilitada para SIP. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
Este parámetro hace que el comando ponga en pausa el procesamiento y requiere que el administrador reconozca qué hará el comando antes de seguir con el procesamiento. El valor predeterminado es $true. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Este parámetro especifica el nombre de dominio completo del controlador (FQDN) de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway |
Este parámetro especifica el parámetro de entrada que representa un nuevo firewall IP. |
Name |
Opcional |
System.String |
Este parámetro especifica el nombre para mostrar que se utilizará para el firewall IP de mensajería unificada. El nombre para mostrar está limitado a 64 caracteres. |
OutcallsAllowed |
Opcional |
System.Boolean |
Este parámetro especifica si permitir este objeto de firewall IP para que se utilice en las llamadas externas. Pero no controla la transferencia de llamadas. |
Port |
Opcional |
System.Int32 |
Este parámetro especifica el puerto IP en el que está escuchando la puerta de enlace IPV o IP PBX. De forma predeterminada, se trata del puerto 5060. El intervalo para este parámetro es de 0 a 65535. |
Simulator |
Opcional |
System.Boolean |
Este parámetro especifica el simulador que se utilizará para el firewall IP de mensajería unificada que está siendo visualizada. Un simulador permite al cliente conectarse al servidor Mensajería unificada. Esta conexión se utiliza normalmente en la aplicación Teléfono de prueba de Exchange. |
Status |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus |
Este parámetro habilita e inhabilita la puerta de enlace IP de mensajería unificada. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
Este parámetro indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, el administrador puede ver los cambios que se producirían sin tener que aplicarlos. El valor predeterminado es $true. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
El primer ejemplo de código modifica la dirección IP de una puerta de enlace IP de MU con nombre MyUMIPGateway.
El segundo ejemplo de código impide que la puerta de enlace IP de MU acepte llamadas entrantes, además de impedir llamadas salientes.
El tercer ejemplo activa la puerta de enlace IP de mensajería unificada para operar como simulador de puerta de enlace IP, y se puede utilizar con el cmdlet Test-UMConnectivity o la aplicación Teléfono de prueba de UM de Exchange.
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false
Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true