> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/de/powershell-befehle/new-psuscript.md). # New-PSUScript ## SYNOPSIS Erstellt ein neues Skript in PowerShell Universal. ## SYNTAX ### ScriptBlock ``` New-PSUScript -ScriptBlock [-ManualTime ] [-TimeOut ] -Name [-Description ] [-Parameter ] [-Tag ] [-Status ] [-Environment ] [-Notes ] [-DisableManualInvocation] [-Path ] [-MaxHistory ] [-ConcurrentJobs ] [-Credential ] [-RetryLimit ] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory ] [-Role ] [-PortalOutputType ] [-AvailableInBranch ] [-PortalOpenInNewWindow] [-Icon ] [-PortalBehavior ] [-PortalLeaveForm] [-DisplayOutputOnExecute] [-ExecutionRole ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Path ``` New-PSUScript [-ManualTime ] [-TimeOut ] -Name [-Description ] [-Parameter ] [-Tag ] [-Status ] [-Environment ] [-Notes ] [-DisableManualInvocation] -Path [-MaxHistory ] [-ConcurrentJobs ] [-Credential ] [-RetryLimit ] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory ] [-Role ] [-PortalOutputType ] [-AvailableInBranch ] [-PortalOpenInNewWindow] [-Icon ] [-PortalBehavior ] [-PortalLeaveForm] [-DisplayOutputOnExecute] [-ExecutionRole ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Module ``` New-PSUScript [-ManualTime ] [-TimeOut ] [-Description ] [-Parameter ] [-Tag ] [-Status ] [-Environment ] [-Notes ] [-DisableManualInvocation] [-MaxHistory ] [-ConcurrentJobs ] [-Credential ] [-RetryLimit ] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory ] -Module -Command [-Role ] [-PortalOutputType ] [-AvailableInBranch ] [-PortalOpenInNewWindow] [-Icon ] [-PortalBehavior ] [-PortalLeaveForm] [-DisplayOutputOnExecute] [-ExecutionRole ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## 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 ``` New-PSUScript -Name 'Script1.ps1' -Path 'Script1.ps1' ``` Erstellt ein Skript in PSU, das einen relativen Pfad von Script1.ps1 im Repository-Ordner referenziert. ### Beispiel 2 ``` New-PSUScript -Name 'Script1.ps1' -ScriptBlock { "Hello, world!" } ``` 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. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -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. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description Die Beschreibung des Skripts. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableManualInvocation Deaktiviert den manuellen Aufruf des Skripts. Das Skript kann nur nach einem Zeitplan ausgeführt werden. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: False Accept pipeline input: False Accept wildcard characters: False ``` ### -ManualTime Die Zeit, die es dauern würde, dieses bestimmte Skript manuell auszuführen. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -MaxHistory Der maximale Auftragsverlauf für dieses Skript. Der Standardwert ist 100. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name Der Name dieses Skripts. ```yaml Type: String Parameter Sets: ScriptBlock, Path Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Notes Notizen, die mit diesem Skript einbezogen werden sollen. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Parameter Veraltet ```yaml Type: ScriptParameter[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Path Der Pfad zum Skript. Dies kann ein relativer Pfad zum Repository-Verzeichnis oder ein absoluter Pfad sein. ```yaml Type: String Parameter Sets: ScriptBlock Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ```yaml Type: String Parameter Sets: Path Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ScriptBlock Ein Skriptblock, der für dieses Skript definiert wird. ```yaml Type: ScriptBlock Parameter Sets: ScriptBlock Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Status Nicht verwendet. ```yaml Type: ScriptStatus Parameter Sets: (All) Aliases: Accepted values: Draft, Pending_Review, Published, Disabled Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Tag Tags, die diesem Skript zugewiesen werden. ```yaml Type: Tag[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ConcurrentJobs Die Anzahl gleichzeitiger Aufträge, die für dieses Skript zulässig sind. Standardmäßig gibt es keine Begrenzung. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Environment Die Umgebung, in der dieses Skript ausgeführt werden soll. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TimeOut Die Anzahl der Minuten, nach denen auf diesem Skript basierende Aufträge ablaufen. ```yaml Type: Double Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Die Benutzer-Anmeldeinformationsvariable, die bei der Ausführung dieses Skripts verwendet werden soll. ```yaml Type: Variable Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Standard-Anmeldeinformationen bei der Verbindung mit der Management API verwenden ```yaml Type: SwitchParameter 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. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -RetryLimit Die Anzahl der Wiederholungsversuche für dieses Skript, wenn es fehlschlägt. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DiscardPipeline Legt fest, ob die Pipeline-Ausgabe verworfen wird, anstatt sie in der Datenbank zu speichern. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoadProfile Lädt das Benutzerprofil, wenn dieses Skript als anderer Benutzer ausgeführt wird. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -WorkingDirectory Das Arbeitsverzeichnis des Skripts. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Command Der Befehl, der dieses Skript definiert. ```yaml Type: String Parameter Sets: Module Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Module Das Modul, das den Befehl enthält, der dieses Skript definiert. ```yaml Type: String Parameter Sets: Module Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Role Die Rolle, die für die Ausführung dieses Skripts erforderlich ist. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AvailableInBranch Wenn angegeben, ist dieses Skript nur in den angegebenen Branches verfügbar. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalOutputType Der Typ der Portalausgabe, die angezeigt wird, wenn dieses Skript im Portal ausgeführt wird. ```yaml Type: PortalOutputType Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Legt fest, ob das Cmdlet Zertifikatsprobleme ignorieren soll. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalOpenInNewWindow Legt fest, ob dieses Skript beim Anzeigen im Portal in einem neuen Fenster geöffnet wird. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Icon Ein Symbol, das im Portal angezeigt wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisplayOutputOnExecute Zeigt die Ausgabe des Skripts an, während es im Portal ausgeführt wird. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalBehavior Wie sich dieses Skript im Portal verhält. ```yaml Type: ScriptPortalBehavior Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalLeaveForm Legt fest, ob das Formular des Skripts nach dessen Ausführung im Portal beibehalten wird. ```yaml 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 Authentifizierungscookies für die aktuelle PowerShell-Sitzung. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ExecutionRole Gibt eine oder mehrere Rollen an, die die Ressource ausführen können. ```yaml Type: String[] 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](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS ### Keine ## OUTPUTS ### System.Object ## NOTES ## RELATED LINKS [Get-PSUScript](https://github.com/Devolutions/docs/tree/master/translations/de/powershell-universal/cmdlets/Get-PSUScript/README.md) [Remove-PSUScript](https://github.com/Devolutions/docs/tree/master/translations/de/powershell-universal/cmdlets/Remove-PSUScript/README.md) [Invoke-PSUScript](https://github.com/Devolutions/docs/tree/master/translations/de/powershell-universal/cmdlets/Invoke-PSUScript/README.md) [Set-PSUScript](https://github.com/Devolutions/docs/tree/master/translations/de/powershell-universal/cmdlets/Set-PSUScript/README.md) [Get-PSUEnvironment](https://github.com/Devolutions/docs/tree/master/translations/de/powershell-universal/cmdlets/Get-PSUEnvironment/README.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/de/powershell-befehle/new-psuscript.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.