For the complete documentation index, see llms.txt. This page is also available as Markdown.

Invoke-PSUScript

ÜBERSICHT

Ruft ein Skript innerhalb von PSU auf.

SYNTAX

Script

Invoke-PSUScript [-Script] <Script> [-WaitForDebugger] [-Environment <String>] [-Notes <String>]
 [-Credential <Variable>] [-Wait] [-Queue <String>] [-WaitTimeout <Int32>] [-Parameters <Hashtable>]
 [-Tags <Tag[]>] [-Silent] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated]
 [-TrustCertificate] [-Cookies] [<CommonParameters>]

Id

Invoke-PSUScript [-Id] <Int64> [-WaitForDebugger] [-Environment <String>] [-Notes <String>]
 [-Credential <Variable>] [-Wait] [-Queue <String>] [-WaitTimeout <Int32>] [-Parameters <Hashtable>]
 [-Tags <Tag[]>] [-Silent] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated]
 [-TrustCertificate] [-Cookies] [<CommonParameters>]

Name

Invoke-PSUScript [-WaitForDebugger] [-Environment <String>] [-Notes <String>] [-Credential <Variable>]
 [-Name] <String> [-Wait] [-Queue <String>] [-WaitTimeout <Int32>] [-Parameters <Hashtable>] [-Tags <Tag[]>]
 [-Silent] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated]
 [-TrustCertificate] [-Cookies] [<CommonParameters>]

BESCHREIBUNG

Ruft ein Skript innerhalb von PSU auf. Das Aufrufen eines Skripts startet einen neuen Job, dessen Fortschritt Sie anschließend verfolgen können.

BEISPIELE

Beispiel 1

Ruft 'Script1.ps1' auf

Beispiel 2

Ruft 'Script1.ps1' mit den Parametern Parameter1 und Parameter2 auf. Diese Parameter werden an das Skript übergeben. Invoke-PSUScript unterstützt eine beliebige Anzahl dynamischer Parameter.

Beispiel 3

Ruft 'Script1.ps1' als Benutzer 'adam' auf. Passwörter werden von Secret-Managern abgerufen und können nicht als Zeichenfolgen übergeben werden.

PARAMETER

-AppToken

Ein App-Token für den Zugriff auf die PSU-API.

-ComputerName

Die HTTP-Adresse des PSU-REST-API-Servers.

-Credential

Die Anmeldeinformationen des Benutzers, unter dem das Skript ausgeführt werden soll. Verwenden Sie New-UACredential, um diese Anmeldeinformationen zu erstellen.

-Environment

Die Umgebung, die beim Aufrufen dieses Skripts verwendet werden soll. Verfügbare Umgebungen können Sie mit Get-PSUEnvironment anzeigen.

-Id

Die ID des aufzurufenden Skripts.

-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.

-Name

Der Name des aufzurufenden Skripts.

-Notes

Notizen, die bei der Job-Ausführung eingeschlossen werden sollen.

-Script

Das aufzurufende Skript. Verwenden Sie Get-PSUScript, um vorhandene Skripte abzurufen.

-UseDefaultCredentials

Standard-Anmeldeinformationen bei der Verbindung mit der Management-API verwenden

-Wait

Wartet auf die Ausführung des Skripts, bevor zurückgegeben wird.

-WaitForDebugger

Nicht verwendet.

-Queue

Der Computer, die Computergruppe oder die Warteschlange, für die dieses Skript ausgeführt werden soll.

-Parameters

Eine Hashtable von Parametern, die an das Skript übergeben werden. Diese kann anstelle dynamischer Parameter dieses Cmdlets verwendet werden.

-WaitTimeout

Die Anzahl der Sekunden, die gewartet werden soll.

-Silent

Verhindert die Interaktion mit dem aktuellen PowerShell-Host. Schreibt nicht in Streams und ruft Read-Host nicht auf.

-Tags

Tags, die auf den Job angewendet werden sollen.

-TrustCertificate

Ob das Cmdlet Zertifikatsprobleme ignorieren soll.

-Cookies

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

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.

EINGABEN

UniversalAutomation.Script

System.Int64

AUSGABEN

System.Object

HINWEISE

Get-PSUEnvironment

Zuletzt aktualisiert

War das hilfreich?