Test-IPAllowListProvider
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-06-28
Utilice 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 utiliza el agente de filtro de conexiones.
Sintaxis
Test-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> -IPAddress <IPAddress> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
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 utilice debe tener delegados los elementos siguientes:
- Función de administrador de servidores de Exchange y grupo local Administradores 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 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.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 utiliza para comprobar y comprobar los proveedores de la lista de IP admitidas que ha configurado. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
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 tengan instalada la función del servidor Transporte perimetral. La función del servidor Transporte perimetral escribe únicamente 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 utiliza el parámetro Server, el comando se ejecuta en el servidor local en el que se ejecuta la tarea. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
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.
|
Matched |
Matched devuelve los siguientes valores: True o False.
|
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