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