New-PSUTrigger

ÜBERSICHT

Erstellt einen neuen Automatisierungstrigger in 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>]

BESCHREIBUNG

Erstellt einen neuen Automatisierungstrigger in PowerShell Universal. Automatisierungstrigger von PowerShell Universal ermöglichen es Ihnen, Skripte basierend auf Ereignissen innerhalb von PowerShell Universal auszuführen. Sie können Skripte ausführen, wenn andere Skripte fehlschlagen, Dashboards stoppen oder wenn der Server gestartet wird.

Trigger werden in der Datei ./universal/triggers.ps1 gespeichert.

Sie können dieses Cmdlet auch verwenden, um Trigger über die REST-API zu erstellen.

BEISPIELE

Beispiel 1

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

Erstellt einen neuen Trigger, der die Datei ScriptFailed.ps1 aufruft, wenn ein Job innerhalb von PowerShell Universal fehlschlägt.

Beispiel 2

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

Erstellt einen neuen Trigger, der die Datei DashboardStopped.ps1 aufruft, wenn das Dashboard MyDashboard stoppt.

Beispiel 3

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

Erstellt einen neuen Trigger, der die Datei LogServerStart.ps1 aufruft, wenn der PowerShell Universal-Server gestartet wird.

PARAMETER

-AppToken

Das App-Token für den Zugriff auf die PowerShell Universal Management-API.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

Der Computername oder die URL des PowerShell Universal-Servers.

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

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

-Dashboard

Trigger für ein bestimmtes Dashboard.

Type: Dashboard
Parameter Sets: (All)
Aliases:

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

-Environment

Die Umgebung, in der das ausgelöste Skript ausgeführt werden soll.

Type: String
Parameter Sets: (All)
Aliases:

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

-EventType

Das Ereignis, das diesen Trigger auslöst.

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

Der Name dieses Triggers. Dieser muss eindeutig sein.

Type: String
Parameter Sets: (All)
Aliases:

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

-Script

Das Skript, das diesen Trigger auslöst.

Type: Script
Parameter Sets: (All)
Aliases:

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

-TriggerScript

Das Skript, das ausgeführt werden soll, wenn dieser Trigger ausgelöst wird.

Type: Script
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Standardanmeldeinformationen bei der Verbindung mit der Management-API verwenden

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Delay

Gibt die Verzögerung zwischen Ausführungen an.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Integrated

Führt den Befehl intern aus, anstatt die Management-API zu verwenden. Funktioniert nur, wenn das Skript innerhalb von PowerShell Universal ausgeführt wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Computer

Der Computer oder die Warteschlange, auf dem bzw. in der dieser Trigger ausgeführt werden soll.

Type: String
Parameter Sets: (All)
Aliases:

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

-Condition

Ein Bedingungs-Skriptblock, der bestimmt, ob dieser Trigger ausgeführt wird oder nicht.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

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

-Credential

Anmeldeinformationen zur Anmeldung an der PowerShell Universal Management-API.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Gibt an, ob das Cmdlet Zertifikatprobleme ignorieren soll.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Cookies

Verwendet und speichert Authentifizierungs-Cookies für die aktuelle PowerShell-Sitzung.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter about_CommonParameters.