Test-IPAllowListProvider (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-06

Use el cmdlet Test-IPAllowListProvider para comprobar la configuración específica para un proveedor de la lista de IP admitidas en un equipo que tenga instalada la función del servidor Transporte de concentradores o de transporte perimetral. Esta configuración la usa el agente de filtro de conexiones.

Sintaxis

Test-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> -IPAddress <IPAddress> [-DomainController <Fqdn>] [-Server <ServerIdParameter>]

Descripción detallada

Este comando comprueba la conectividad con el proveedor de la lista de IP admitidas especificado y, a continuación, envía una solicitud de búsqueda al proveedor de la lista de IP admitidas. Cuando compruebe la conexión y la funcionalidad del proveedor de la lista de IP admitidas, tendrá que indicar una dirección IP permitida en el parámetro IPAddress.

Para ejecutar el cmdlet Test-IPAllowListProvider, la cuenta que use debe tener delegados los elementos siguientes:

  • Función Administrador de Exchange Server y grupo Administradores local para el servidor de destino

Para ejecutar el cmdlet Test-IPAllowListProvider en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo local de administradores de dicho equipo.

Para obtener más información sobre 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.IPAllowListProviderIdParameter

Escriba en este parámetro el nombre de proveedor de la lista de IP admitidas. El parámetro Identity debe coincidir con el parámetro Name o con el parámetro Identity (GUID) del proveedor de la lista de IP admitidas que desee comprobar.

IPAddress

Necesario

System.Net.IPAddress

El parámetro IPAddress se usa para comprobar y comprobar los proveedores de la lista de IP admitidas que ha configurado.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) 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 comando. El parámetro DomainController no se admite en equipos que tienen instalada la función del servidor Transporte perimetral. La función del servidor Transporte perimetral sólo escribe en la instancia de ADAM local.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Para especificar el servidor en el que se ejecuta el cmdlet Test-IPAllowListProvider, incluya el parámetro Server en el comando. Si no usa el parámetro Server, el comando se ejecuta en el servidor local en el que se ejecuta la tarea.

Tipos de entrada

Tipos de valores devueltos

Resultados Descripción

Allow List Provider

Allow List Provider devuelve el objeto de proveedor de la lista de IP admitidas tal y como se ha almacenado en el directorio de ADAM local o en el servicio de directorio de Active Directory.

Connected

Connected devuelve los siguientes valores: True o False.

  • True   Se supera la prueba de conectividad.

  • False   No se supera la prueba de conectividad.

Matched

Matched devuelve los siguientes valores: True o False.

  • True   El parámetro IPAddress que se ha enviado con el comando Test-IPAllowListProvider coincide con la dirección IP del proveedor de la lista de IP admitidas.

  • False   El parámetro IPAddress que se ha enviado con el comando Test-IPAllowListProvider no coincide con la dirección IP del proveedor de la lista de IP admitidas.

ProviderResult

ProviderResult devuelve una dirección IP, que representa el estado, según el proveedor de la lista de IP admitidas, del parámetro IPAddress que se ha enviado en el comando Test-IPAllowListProvider. Póngase en contacto con el proveedor de la lista de IP admitidas para determinar el significado de la dirección IP que se ha devuelto.

Errores

Error Descripción

Permisos insuficientes

Debe iniciar sesión con una cuenta que sea miembro del grupo local de administradores del equipo local con la función del servidor Transporte perimetral instalada para ejecutar este comando.

No se puede conectar con ADAM

Si está ejecutando esta tarea desde un equipo que tiene instalada la función del servidor Transporte perimetral, compruebe que el servicio de ADAM (MsExchangeAdam) se esté ejecutando en el equipo local. Si, por el contrario, el equipo tiene instalada la función del servidor Transporte de concentradores, compruebe que éste puede conectarse con Active Directory.

No se puede establecer conexión con el proveedor de la lista de IP admitidas

Póngase en contacto con el proveedor de la lista de IP admitidas.

Ejemplo

El ejemplo de código siguiente muestra un comando Test-IPAllowListProvider que tiene los parámetros obligatorios. El comando comprueba la conectividad con un proveedor ficticio de la lista de IP admitidas denominado ExampleProviderName y, a continuación, envía una solicitud de búsqueda a ese proveedor.

Test-IPAllowListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName