New-PSUScript
SYNOPSIS
Erstellt ein neues Skript in PowerShell Universal.
SYNTAX
ScriptBlock
New-PSUScript -ScriptBlock <ScriptBlock> [-ManualTime <Int32>] [-TimeOut <Double>] -Name <String>
[-Description <String>] [-Parameter <ScriptParameter[]>] [-Tag <Tag[]>] [-Status <ScriptStatus>]
[-Environment <String>] [-Notes <String>] [-DisableManualInvocation] [-Path <String>] [-MaxHistory <Int32>]
[-ConcurrentJobs <Int32>] [-Credential <Variable>] [-RetryLimit <Int32>] [-DiscardPipeline] [-LoadProfile]
[-WorkingDirectory <String>] [-Role <String[]>] [-PortalOutputType <PortalOutputType>]
[-AvailableInBranch <String[]>] [-PortalOpenInNewWindow] [-Icon <String>]
[-PortalBehavior <ScriptPortalBehavior>] [-PortalLeaveForm] [-DisplayOutputOnExecute]
[-ExecutionRole <String[]>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials]
[-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]Path
New-PSUScript [-ManualTime <Int32>] [-TimeOut <Double>] -Name <String> [-Description <String>]
[-Parameter <ScriptParameter[]>] [-Tag <Tag[]>] [-Status <ScriptStatus>] [-Environment <String>]
[-Notes <String>] [-DisableManualInvocation] -Path <String> [-MaxHistory <Int32>] [-ConcurrentJobs <Int32>]
[-Credential <Variable>] [-RetryLimit <Int32>] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory <String>]
[-Role <String[]>] [-PortalOutputType <PortalOutputType>] [-AvailableInBranch <String[]>]
[-PortalOpenInNewWindow] [-Icon <String>] [-PortalBehavior <ScriptPortalBehavior>] [-PortalLeaveForm]
[-DisplayOutputOnExecute] [-ExecutionRole <String[]>] [-ComputerName <String>] [-AppToken <String>]
[-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Module
DESCRIPTION
Erstellt ein neues Skript in PowerShell Universal. Skripte können in PSU manuell ausgeführt oder geplant werden. Skripte, die auf Basis von Inhalten erstellt werden, werden in das Repository-Verzeichnis geschrieben. Über einen Pfad erstellte Skripte werden über diesen Pfad referenziert.
Skriptkonfigurationen werden in .universal/scripts.ps1 gespeichert
Sie können dieses Cmdlet auch verwenden, um Skripte über die REST-API zu erstellen.
EXAMPLES
Beispiel 1
Erstellt ein Skript in PSU, das einen relativen Pfad von Script1.ps1 im Repository-Ordner referenziert.
Beispiel 2
Erstellt ein Skript in PSU basierend auf dem angegebenen Skriptblock. Dadurch wird eine Datei Script1.ps1 im Repository-Verzeichnis erstellt.
PARAMETERS
-AppToken
Das AppToken, das für den Aufruf der PowerShell Universal Management API verwendet wird. Sie können auch Connect-PSUServer vor dem Aufruf dieses Cmdlets ausführen, um das AppToken für die gesamte Sitzung festzulegen.
-ComputerName
Gibt den Computernamen oder die URL an, die beim Zugriff auf die PowerShell Universal Management API aufgerufen werden soll. Sie können auch Connect-PSUServer vor dem Aufruf dieses Cmdlets verwenden, um den Computernamen für die gesamte Sitzung festzulegen.
-Description
Die Beschreibung des Skripts.
-DisableManualInvocation
Deaktiviert den manuellen Aufruf des Skripts. Das Skript kann nur nach einem Zeitplan ausgeführt werden.
-ManualTime
Die Zeit, die es dauern würde, dieses bestimmte Skript manuell auszuführen.
-MaxHistory
Der maximale Auftragsverlauf für dieses Skript. Der Standardwert ist 100.
-Name
Der Name dieses Skripts.
-Notes
Notizen, die mit diesem Skript einbezogen werden sollen.
-Parameter
Veraltet
-Path
Der Pfad zum Skript. Dies kann ein relativer Pfad zum Repository-Verzeichnis oder ein absoluter Pfad sein.
-ScriptBlock
Ein Skriptblock, der für dieses Skript definiert wird.
-Status
Nicht verwendet.
-Tag
Tags, die diesem Skript zugewiesen werden.
-ConcurrentJobs
Die Anzahl gleichzeitiger Aufträge, die für dieses Skript zulässig sind. Standardmäßig gibt es keine Begrenzung.
-Environment
Die Umgebung, in der dieses Skript ausgeführt werden soll.
-TimeOut
Die Anzahl der Minuten, nach denen auf diesem Skript basierende Aufträge ablaufen.
-Credential
Die Benutzer-Anmeldeinformationsvariable, die bei der Ausführung dieses Skripts verwendet werden soll.
-UseDefaultCredentials
Standard-Anmeldeinformationen bei der Verbindung mit der Management API verwenden
-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.
-RetryLimit
Die Anzahl der Wiederholungsversuche für dieses Skript, wenn es fehlschlägt.
-DiscardPipeline
Legt fest, ob die Pipeline-Ausgabe verworfen wird, anstatt sie in der Datenbank zu speichern.
-LoadProfile
Lädt das Benutzerprofil, wenn dieses Skript als anderer Benutzer ausgeführt wird.
-WorkingDirectory
Das Arbeitsverzeichnis des Skripts.
-Command
Der Befehl, der dieses Skript definiert.
-Module
Das Modul, das den Befehl enthält, der dieses Skript definiert.
-Role
Die Rolle, die für die Ausführung dieses Skripts erforderlich ist.
-AvailableInBranch
Wenn angegeben, ist dieses Skript nur in den angegebenen Branches verfügbar.
-PortalOutputType
Der Typ der Portalausgabe, die angezeigt wird, wenn dieses Skript im Portal ausgeführt wird.
-TrustCertificate
Legt fest, ob das Cmdlet Zertifikatsprobleme ignorieren soll.
-PortalOpenInNewWindow
Legt fest, ob dieses Skript beim Anzeigen im Portal in einem neuen Fenster geöffnet wird.
-Icon
Ein Symbol, das im Portal angezeigt wird.
-DisplayOutputOnExecute
Zeigt die Ausgabe des Skripts an, während es im Portal ausgeführt wird.
-PortalBehavior
Wie sich dieses Skript im Portal verhält.
-PortalLeaveForm
Legt fest, ob das Formular des Skripts nach dessen Ausführung im Portal beibehalten wird.
-Cookies
Verwendet und speichert Authentifizierungscookies für die aktuelle PowerShell-Sitzung.
-ExecutionRole
Gibt eine oder mehrere Rollen an, die die Ressource ausführen können.
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.
INPUTS
Keine
OUTPUTS
System.Object
NOTES
RELATED LINKS
Zuletzt aktualisiert
War das hilfreich?