Set-UMIPGateway (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-07-12
El cmdlet Set-UMIPGateway se utiliza para modificar las opciones de configuración de una única puerta de enlace IP de mensajería unificada (MU) o para devolver una lista de opciones de configuración que pueden modificarse en una puerta de enlace IP de mensajería unificada dada.
Sintaxis
Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
Set-UMIPGateway [-Address <UMSmartHost>] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>]
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 SIP habilitado o una puerta de enlace IP.
Importante
Es posible que las modificaciones en la configuración de la puerta de enlace IP de mensajería unificada desestabilicen la comunicación entre los servidores de 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 las puede realizar 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, debe utilizar una cuenta en la que se delegue lo siguiente:
- Función Administrador de organización de Exchange
Para obtener más información sobre los permisos, funciones de delegación 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 la puerta de enlace IP de mensajería unificada que está siendo modificada. Este parámetro es el Id. del objeto de directorio para la puerta de enlace IP de mensajería unificada. |
Dirección |
Opcional |
Microsoft.Exchange.Data.UMSmartHost |
Este parámetro especifica la dirección IP que está configurada en la puerta de enlace IP o IP/Private Branch eXchange (PBX) con Protocolo de inicio de sesión habilitado (SIP). |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el cmdlet. |
Instance |
Opcional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway |
Este parámetro especifica el parámetro de entrada que representa una nueva puerta de enlace IP. |
Name |
Opcional |
System.String |
Este parámetro especifica el nombre para mostrar que se utilizará para la puerta de enlace IP de mensajería unificada. El nombre para mostrar está limitado a 64 caracteres. |
OutcallsAllowed |
Opcional |
System.Boolean |
Este parámetro especifica si se permite que este objeto de puerta de enlace IP se utilice en las llamadas salientes. 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 la puerta de enlace IP de mensajería unificada que está siendo visualizada. Un simulador permite al cliente conectarse al servidor de 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. |
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 habilita la puerta de enlace IP de MU para que funcione como un simulador de IP/VoIP.
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