Invoke-PSUTest

Ejecuta un fichero o una carpeta de pruebas Pester de PowerShell Universal y, opcionalmente, espera y devuelve sus resultados.

SINOPSIS

Inicia una ejecución de pruebas Pester en PowerShell Universal.

SINTAXIS

Invoke-PSUTest -Path <String> [-Environment <String>] [-Tag <String[]>] [-ExcludeTag <String[]>] [-Test <String[]>] [-Wait] [-Timeout <Int32>] [-IncludeSuite] [<ConnectionOptions>] [<CommonParameters>]
Invoke-PSUTest -TestFile <TestFile> [-Environment <String>] [-Tag <String[]>] [-ExcludeTag <String[]>] [-Test <String[]>] [-Wait] [-Timeout <Int32>] [-IncludeSuite] [<ConnectionOptions>] [<CommonParameters>]

<ConnectionOptions>: [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies].

DESCRIPCIÓN

Inicia una ejecución de pruebas de Pester y devuelve un registro de ejecución de pruebas. Utilice los filtros de etiqueta y de nombre de prueba para seleccionar las pruebas. -Wait consulta hasta la finalización; -Timeout es de 300 segundos de forma predeterminada y 0 deshabilita el tiempo de espera. -IncludeSuite devuelve un objeto que contiene TestRun y TestSuite (con o sin -Wait).

EJEMPLOS

Invoke-PSUTest -Path '.\tests\api.tests.ps1'
Invoke-PSUTest -Path '.\tests\api.tests.ps1' -Tag Smoke -ExcludeTag Slow
Invoke-PSUTest -Path '.\tests\api.tests.ps1' -Test 'API returns 200'
Invoke-PSUTest -Path '.\tests\api.tests.ps1' -Wait -IncludeSuite

PARÁMETROS

Parámetro	Descripción
-Path	Ruta obligatoria del archivo o de la carpeta de pruebas (conjunto de parámetros Path).
-TestFile	Objeto de archivo de pruebas obligatorio; acepta la entrada de la canalización (conjunto de parámetros TestFile).
-Environment	Entorno de ejecución para la ejecución de pruebas.
-Tag	Incluye las pruebas que tienen estas etiquetas de Pester (alias -TagFilter).
-ExcludeTag	Excluye las pruebas que tienen estas etiquetas (alias -ExcludeTagFilter).
-Test	Filtros de nombre completo de Pester (alias -FullName, -FullNameFilter, -Tests).
-Wait	Espera a que finalice antes de devolver el resultado.
-Timeout	Tiempo de espera en segundos, 300 de forma predeterminada; 0 lo deshabilita.
-IncludeSuite	Devuelve tanto la ejecución de pruebas como la suite analizada.
-ComputerName	URL o nombre de host de la API de administración de PSU (alias -Uri).
-AppToken	Token de aplicación de la API de administración.
-Credential	Credenciales de la API de administración.
-UseDefaultCredentials	Usa las credenciales actuales de Windows.
-Integrated	Usa el cliente de administración en proceso.
-TrustCertificate	Ignora los errores de validación del certificado.
-Cookies	Reutiliza las cookies de autenticación de la sesión.

SALIDAS

PowerShellUniversal.Models.Testing.TestRun, o un objeto que contiene TestRun y TestSuite cuando se especifica -IncludeSuite.

PERMISOS

El token de acceso requiere automation.tests/execute para ejecutar este cmdlet de forma remota.