New-PSUTrigger

SYNOPSIS

Crée un nouveau déclencheur d'automatisation dans PowerShell Universal.

SYNTAXE

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

Crée un nouveau déclencheur d'automatisation dans PowerShell Universal. Les déclencheurs d'automatisation de Powershell Universal vous permettent d'exécuter des scripts en fonction d'événements survenant dans PowerShell Universal. Vous pouvez exécuter des scripts lorsque d'autres scripts échouent, lorsque des tableaux de bord s'arrêtent ou lorsque le serveur démarre.

Les déclencheurs sont stockés dans le fichier ./universal/triggers.ps1.

Vous pouvez également utiliser cette applet de commande pour créer des déclencheurs via l'API REST.

EXEMPLES

Exemple 1

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

Crée un nouveau déclencheur qui appelle le fichier ScriptFailed.ps1 lorsqu'une tâche dans PowerShell Universal échoue.

Exemple 2

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

Crée un nouveau déclencheur qui appelle le fichier DashboardStopped.ps1 lorsque le tableau de bord MyDashboard s'arrête.

Exemple 3

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

Crée un nouveau déclencheur qui appelle le fichier LogServerStart.ps1 lorsque le serveur PowerShell Universal démarre.

PARAMÈTRES

-AppToken

Le jeton d'appli pour accéder à l'API de gestion 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

Le nom d'ordinateur ou l'URL du serveur 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

Déclencheurs pour un tableau de bord spécifique.

Type: Dashboard
Parameter Sets: (All)
Aliases:

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

-Environment

L'environnement dans lequel exécuter le script déclenché.

Type: String
Parameter Sets: (All)
Aliases:

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

-EventType

L'événement qui provoque ce déclencheur.

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

Le nom de ce déclencheur. Il doit être unique.

Type: String
Parameter Sets: (All)
Aliases:

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

-Script

Le script qui provoque ce déclencheur.

Type: Script
Parameter Sets: (All)
Aliases:

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

-TriggerScript

Le script à exécuter lorsque ce déclencheur est déclenché.

Type: Script
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Utiliser les identifiants par défaut lors de la connexion à l'API de gestion

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Delay

Spécifie le délai entre les exécutions.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Integrated

Exécute la commande en interne plutôt qu'en utilisant l'API de gestion. Fonctionne uniquement lors de l'exécution d'un script depuis PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Computer

L'ordinateur ou la file d'attente sur lequel exécuter ce déclencheur.

Type: String
Parameter Sets: (All)
Aliases:

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

-Condition

Un bloc de script de condition permettant de déterminer si ce déclencheur doit être exécuté ou non.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

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

-Credential

Identifiants pour se connecter à l'API de gestion 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

Indique si l'applet de commande doit ignorer les problèmes de certificat.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Cookies

Réutilise et conserve les témoins d'authentification pour la session PowerShell actuelle.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable et -ProgressAction. Pour plus d'informations, consultez about_CommonParameters.

ENTRÉES

Aucune

SORTIES

System.Object

NOTES

LIENS CONNEXES

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