Test-PopConnectivity
Este cmdlet solo está disponible en el entorno local de Exchange.
Use el cmdlet Test-PopConnectivity para comprobar que el servicio POP3 de Microsoft Exchange funciona según lo previsto.
Nota: Este cmdlet funciona mejor en Exchange 2010. En versiones posteriores de Exchange, la funcionalidad de este cmdlet se ha reemplazado por Disponibilidad administrada. Para obtener los mejores resultados, use el cmdlet Invoke-MonitoringProbe y especifique el sondeo de monitor activo pertinente en lugar de usar este cmdlet.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Syntax
Test-PopConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-Confirm]
[-ConnectionType <ProtocolConnectionType>]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-MonitoringContext]
[-PerConnectionTimeout <Int32>]
[-PortClientAccessServer <Int32>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Description
El cmdlet Test-PopConnectivity prueba la conectividad POP3 mediante la conexión a un buzón de correo especificado, a un servidor de Exchange especificado o a todos los servidores de Exchange que están disponibles en el sitio local de Active Directory.
La primera vez que use este cmdlet es posible que tenga que crear un usuario de prueba. Para crear un usuario de prueba, ejecute el siguiente comando:
& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1
Los resultados de la prueba se muestran en pantalla. El cmdlet devuelve la siguiente información.
- CasServer: el servidor de Exchange al que se conectó el cliente.
- LocalSite: nombre del sitio de Active Directory local.
- Escenario: las operaciones que se prueban. La conectividad POP3 de prueba se conecta al servidor mediante el protocolo POP3, busca el mensaje de prueba y elimina el mensaje de prueba.
- Resultado: los valores devueltos suelen ser Correcto, Omitido o Error.
- Latencia (MS): tiempo necesario para completar la prueba en milisegundos.
- Error: cualquier mensaje de error que se encontró.
Puede escribir los resultados en un archivo canalizando la salida a ConvertTo-Html y Set-Content. Por ejemplo: Test-PopConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\POP Test.html".
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
Test-PopConnectivity -ClientAccessServer Contoso12 -MailboxCredential (Get-Credential contoso\kweku)En este ejemplo se prueba la conectividad POP3 del cliente para el servidor denominado Contoso12 mediante las credenciales del usuario contoso\kweku.
Ejemplo 2
Test-PopConnectivity -ClientAccessServer Contoso12En este ejemplo se prueba la conectividad POP3 del cliente del servidor específico denominado Contoso12 y se prueban todos los buzones de Exchange.
Parámetros
-ClientAccessServer
El parámetro ClientAccessServer especifica el servidor de Exchange que se va a probar. Este servidor tiene instalado el rol de servidor de acceso de cliente y es responsable de aceptar las conexiones de cliente.
Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:
- Nombre
- Nombre completo (DN)
- ExchangeLegacyDN
- GUID
| Type: | ServerIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConnectionType
El parámetro ConnectionType especifica el tipo de conexión que se usa para conectarse al servicio POP3. Los valores admitidos son:
- Plaintext
- Ssl
- Tls
| Type: | ProtocolConnectionType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LightMode
El modificador LightMode indica al comando que realice solo un inicio de sesión de prueba en el servidor mediante el protocolo POP3. No es necesario especificar un valor con este modificador.
Si no usa este modificador, el comando también prueba la recepción de un mensaje mediante el protocolo POP3.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxCredential
El parámetro MailboxCredential especifica la credencial de buzón que se va a usar para una prueba de buzón de correo única.
Un valor para este parámetro requiere el cmdlet Get-Credential. Para pausar este comando y recibir una solicitud de credenciales, use el valor (Get-Credential). O bien, antes de ejecutar este comando, almacene las credenciales en una variable (por ejemplo, $cred = Get-Credential) y, a continuación, use el nombre de variable ($cred) para este parámetro. Para más información, vea Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxServer
El parámetro MailboxServer especifica el servidor de buzón de Exchange que desea probar. Este parámetro identifica el servidor back-end que acepta conexiones proxy desde el servidor front-end donde se conectan los clientes.
El parámetro MailboxServer especifica el servidor de buzones de correo de exExchange2k16 o exExchange2k13 que quiere probar. Por ejemplo:
- Nombre
- Nombre completo (DN)
- ExchangeLegacyDN
- GUID
Si no usa este parámetro, se probarán las conexiones a todos los servidores de buzones del sitio local de Active Directory.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MonitoringContext
El conmutador MonitoringContext incluye o excluye los eventos de supervisión y contadores de rendimiento asociados en los resultados. No es necesario especificar un valor con este modificador.
Normalmente, se incluyen los eventos de supervisión y los contadores de rendimiento en los resultados cuando la salida se pasa a Microsoft System Center Operations Manager (SCOM).
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PerConnectionTimeout
El parámetro PerConnectionTimeout especifica la cantidad de tiempo, en segundos, que hay que esperar para que se complete la operación de prueba. Los valores válidos son de 0 a 120 segundos. El valor predeterminado es 120 segundos.
Le recomendamos que configure este parámetro con un valor de 5 segundos o más.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PortClientAccessServer
El parámetro PortClientAccessServer especifica el puerto que usar para conectar con el servidor Acceso de clientes. El puerto predeterminado es 110 para POP3. El intervalo válido puede ser de 0 a 65.535.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResetTestAccountCredentials
El modificador ResetTestAccountCredentials restablece la contraseña de la cuenta de prueba que se usa para ejecutar este comando. No es necesario especificar un valor con este modificador.
La contraseña de la cuenta de prueba se suele restablecer normalmente cada siete días. Use este modificador para obligar a restablecer la contraseña siempre que sea necesario por motivos de seguridad.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Timeout
El parámetro Timeout especifica la cantidad de tiempo, en segundos, que hay que esperar para que se complete la operación de prueba. Los valores válidos son de 0 a 3600 segundos (1 hora). El valor predeterminado es 180 segundos (3 minutos).
Le recomendamos que configure este parámetro con un valor de 5 segundos o más.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TrustAnySSLCertificate
El modificador TrustAnySSLCertificate permite a Exchange aceptar certificados de entidades de certificación (CA) que no son de confianza. No es necesario especificar un valor con este modificador.
El modificador TrustAnySSLCertificate especifica si se deben omitir los errores de validación de certificado de Secure Sockets Layer (SSL). No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de