New-PSUTrigger

SYNOPSIS

Crea un nuevo desencadenador de Automation en PowerShell Universal.

SYNTAX

New-PSUTrigger -Name <String> -EventType <EventType> -TriggerScript <Script> [-Script <Script>]
 [-Dashboard <Dashboard>] [-Environment <String>] [-Delay <Int32>] [-Computer <String>]
 [-Condition <ScriptBlock>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

DESCRIPTION

Crea un nuevo desencadenador de Automation en PowerShell Universal. Los desencadenadores de Automation de PowerShell Universal le permiten ejecutar scripts en función de eventos dentro de PowerShell Universal. Puede ejecutar scripts cuando otros scripts fallan, cuando los paneles se detienen o cuando el servidor se está iniciando.

Los desencadenadores se almacenan en el fichero ./universal/triggers.ps1.

También puede utilizar este cmdlet para crear desencadenadores a través de la API REST.

EXAMPLES

Ejemplo 1

New-PSUTrigger -Name 'Script Failed' -EventType JobFailed -TriggerScript 'ScriptFailed.ps1'

Crea un nuevo desencadenador que llama al fichero ScriptFailed.ps1 cuando falla cualquier trabajo dentro de PowerShell Universal.

Ejemplo 2

New-PSUTrigger -Name 'Dashboard Stopped' -Dashboard 'MyDashboard' -EventType DashboardStopped -TriggerScript 'DashboardStopped.ps1'

Crea un nuevo desencadenador que llama al fichero DashboardStopped.ps1 cuando se detiene el panel MyDashboard.

Ejemplo 3

New-PSUTrigger -Name 'Server Started' -EventType ServerStarted -TriggerScript 'LogServerStart.ps1'

Crea un nuevo desencadenador que llama al fichero LogServerStart.ps1 cuando se inicia el servidor de PowerShell Universal.

PARAMETERS

-AppToken

El token de aplicación para acceder a la API de gestión de PowerShell Universal.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName

El nombre de equipo o la URL del servidor de PowerShell Universal.

Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Dashboard

Desencadenadores para un panel específico.

Type: Dashboard
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Environment

El entorno en el que se ejecutará el script desencadenado.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EventType

El evento que provoca este desencadenador.

Type: EventType
Parameter Sets: (All)
Aliases:
Accepted values: JobCanceled, JobFailed, JobCompleted, JobStarted, JobFeedbackRequested, ServerStarted, ServerStopped, DashboardStarted, DashboardStopped

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

El nombre de este desencadenador. Debe ser único.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Script

El script que provoca este desencadenador.

Type: Script
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TriggerScript

El script que se ejecutará cuando se active este desencadenador.

Type: Script
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultCredentials

Utilizar las credenciales predeterminadas al conectarse a la API de gestión

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Delay

Especifica el retardo entre ejecuciones.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Integrated

Ejecuta el comando internamente en lugar de utilizar la API de gestión. Solo funciona al ejecutar el script desde dentro de PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Computer

El equipo o la cola en la que se ejecutará este desencadenador.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Condition

Un bloque de script de condición para determinar si se debe ejecutar este desencadenador o no.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Credenciales para iniciar sesión en la API de gestión de PowerShell Universal.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TrustCertificate

Indica si el cmdlet debe ignorar los problemas de certificado.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cookies

Reutiliza y conserva las cookies de autenticación de la sesión actual de PowerShell.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para obtener más información, consulte about_CommonParameters.

INPUTS

Ninguno

OUTPUTS

System.Object

NOTES

RELATED LINKS

New-PSUScript New-PSUDashboard Get-PSUDashboard Get-PSUScript