Test-PowerShellConnectivity
Este cmdlet solo está disponible en el entorno local de Exchange.
Use el cmdlet Test-PowerShellConnectivity para probar la conectividad del cliente con directorios virtuales remotos de PowerShell de Exchange.
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-PowerShellConnectivity
-ConnectionUri <Uri>
-TestCredential <PSCredential>
[-Authentication <AuthenticationMethod>]
[-Confirm]
[-DomainController <Fqdn>]
[-MailboxServer <ServerIdParameter>]
[-MonitoringContext]
[-ResetTestAccountCredentials]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Test-PowerShellConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-TestType <OwaConnectivityTestType>]
[-VirtualDirectoryName <String>]
[-Authentication <AuthenticationMethod>]
[-Confirm]
[-DomainController <Fqdn>]
[-MailboxServer <ServerIdParameter>]
[-MonitoringContext]
[-ResetTestAccountCredentials]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Description
El cmdlet Test-PowerShellConnectivity prueba la conectividad remota de PowerShell de Exchange mediante la conexión a un directorio virtual de PowerShell remoto especificado, a cualquier directorio virtual remoto de PowerShell en un servidor de Exchange especificado o a cualquier directorio virtual remoto de PowerShell que esté disponible 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. Los valores son: Logon User.
- 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-PowerShellConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\PowerShell 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-PowerShellConnectivity -ClientAccessServer MBX2 -VirtualDirectoryName "PowerShell (Default Web Site)" -TrustAnySSLCertificateEn este ejemplo se prueba el directorio virtual de PowerShell (sitio web predeterminado) en el servidor MBX2. Se usa el modificador TrustAnySSLCertificate para omitir la comprobación del certificado durante la conexión.
Ejemplo 2
$UserCredentials = Get-Credential
Test-PowerShellConnectivity -ConnectionUri https://contoso.com/powershell -TestCredential $UserCredentials -Authentication BasicEn este ejemplo se prueba el directorio virtual remoto de PowerShell que está disponible en https://contoso.com/powershell. No se espera ninguna discordancia entre el certificado SSL y la dirección URL, por lo que el modificador de TrustAnySSLCertificate no se usa. El directorio virtual está configurado para usar la autenticación básica.
Las credenciales que se usan para conectarse al directorio virtual se almacenan en la variable $UserCredentials. A continuación, la prueba se ejecuta tal como se describió anteriormente.
Parámetros
-Authentication
El parámetro Authentication especifica el tipo de autenticación que se usa para conectarse. Los valores admitidos son:
- Predeterminada
- Basic
- Credssp
- Digest
- Kerberos
- Negociar
| Type: | AuthenticationMethod |
| 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 |
-ClientAccessServer
El parámetro ClientAccessServer especifica el servidor de Exchange que se va a probar. Este servidor tiene instalado el rol de servidor 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
Este parámetro no se puede usar con el parámetro ConnectionUri.
| 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 |
-ConnectionUri
El parámetro ConnectionUri especifica la dirección URL del directorio virtual remoto de PowerShell que se va a probar, por ejemplo, https://contoso.com/powershell.
Este parámetro no se puede usar con el parámetro ClientAccessServer.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-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 |
-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 |
-TestCredential
El parámetro TestCredential especifica las credenciales que hay que usar para la prueba.
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.
Solo puede usar este parámetro con el parámetro ConnectionUri.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TestType
El parámetro TestType especifica si el comando comprueba las direcciones URL internas o externas. Los valores válidos son Internal y External. El valor predeterminado es Internal.
Este parámetro solo se puede usar con el parámetro ClientAccessServer.
| Type: | OwaConnectivityTestType |
| 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 |
-VirtualDirectoryName
El parámetro VirtualDirectoryName especifica el nombre del directorio virtual de PowerShell remoto que desea probar. Escriba los valores que contengan espacios entre comillas (").
Este parámetro solo se puede usar con el parámetro ClientAccessServer. Si no usa este parámetro, se probarán todos los directorios virtuales de PowerShell remotos disponibles en el servidor.
| Type: | String |
| 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.