> 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/automatisierung/jobs.md). # Jobs Verfolgen Sie PowerShell Universal-Jobs, prüfen Sie Ausgabe und Status, konfigurieren Sie Schutzmechanismen für Ausgaben und die Maskierung vertraulicher Daten und rufen Sie Jobs aus Skripten, Apps un Jobs sind Skriptausführungen. Zeigen Sie sie unter **Run > Jobs** an, um Status, Stream-Ausgabe, Pipeline-Ausgabe, Fehler, Feedback-Anfragen, Skriptversion und Job-Metadaten zu prüfen. ## Ausgabe Die PowerShell-Stream-Ausgabe, einschließlich Information-, Host-, Fehler-, Warnungs- und Verbose-Einträgen, wird im Job-Ausgabebereich angezeigt. In die Pipeline geschriebene Objekte werden als CliXml gespeichert und sind über die Registerkarte **Pipeline Output** verfügbar. Konfigurieren Sie **Large job output behavior** und **Maximum job output size (KB)** unter **Einstellungen-Zahnrad > Automatisierung**, um die Instanz vor übermäßiger Ausgabe zu schützen. Der Standardhöchstwert beträgt **10.240 KB**; setzen Sie ihn auf `0`, um die Beschränkung zu deaktivieren. | Verhalten | Ergebnis | | --------- | ---------------------------------------------------------------------------------- | | Warn | Behält die Ausgabe bei und erzeugt eine Warnung. Dies ist die Standardeinstellung. | | Truncate | Speichert die Ausgabe nur bis zur Beschränkung. | | Compress | Speichert die überschüssige Ausgabe in komprimierter Form. | | Ignore | Wendet weder die Beschränkung noch das Warnverhalten an. | Sie können die Pipeline-Ausgabe für ein einzelnes Skript auch über dessen Einstellung **Discard Pipeline** verwerfen. ### Vertrauliche Job-Ausgabe maskieren Aktivieren Sie **Redact sensitive job output** unter **Einstellungen-Zahnrad > Automatisierung**, um Werte in der Job-Ausgabe zu maskieren, bevor die Ausgabe protokolliert oder gespeichert wird. Die Maskierung ist standardmäßig deaktiviert. Wenn diese Option aktiviert ist, ersetzt PowerShell Universal übereinstimmende Werte durch `********` für integrierte vertrauliche Schlüsselnamen, darunter `password`, `secret`, `client_secret`, `api_key`, `access_token`, `token`, `authorization`, `credential` und `connection_string`. Dabei werden gängige Schlüssel-Wert-Formate wie JSON, HTTP-Formular- oder Query-String-Daten und durch Doppelpunkt getrennte Ausgaben erkannt. ```powershell Write-Host '{"password": "MyPassword"}' # Job output: {"password": "********"} Write-Host 'client_secret=MyClientSecret' # Job output: client_secret=******** Write-Host 'Authorization: [value]' # Job output: Authorization: ******** ``` Fügen Sie organisationsspezifische Feldnamen über **Additional sensitive output keys** auf derselben Einstellungsseite hinzu. Diese Schlüssel verwenden dieselben Übereinstimmungsmuster wie die integrierten Schlüssel. Die Maskierung ist ein Best-Effort-Sicherheitsnetz für Ausgaben und kein umfassender Secret-Scanner. Sie maskiert keine Werte, die nicht als erkannte Schlüssel-Wert-Paare ausgegeben werden, einschließlich Werten, die in benutzerdefinierter Objektformatierung eingebettet sind oder von einem Secret-Anbieter abgerufen wurden. Schreiben Sie keine Geheimnisse in die Job-Ausgabe. ## Skriptversion Jeder Job zeichnet die aufgelöste Version des Skripts auf, mit dem er gestartet wurde. Suchen Sie das Tag **Script Version** in der Job-Kopfzeile, um die für diese Ausführung verwendete Quelle zu identifizieren. * Skripte aus Git-synchronisierten Repositorys zeichnen den aufgelösten Git-Commit-SHA auf. * Skripte aus Modulbefehlen zeichnen die aufgelöste Modulversion auf. Der aufgezeichnete Wert bleibt auch nach Änderungen am Skript oder Modul beim Job erhalten und liefert so ein Prüfprotokoll zum Ausführungszeitpunkt. Erneut ausgeführte Jobs verwenden die aktuell aufgelöste Skriptversion, sofern verfügbar; andernfalls behalten sie die ursprünglich aufgezeichnete Version bei. ## Status und Feedback Jobs können den Status **Queued**, **Running**, **Error**, **Warning**, **Failed** oder **Waiting on Feedback** haben. Ein `Read-Host`-Aufruf versetzt einen Job in den Status Waiting on Feedback; antworten Sie über die Job-Seite. Verwenden Sie `Read-Host -AsSecureString` für die Passworteingabe. ## Jobs aufrufen Verwenden Sie `Invoke-PSUScript`, um einen Job zu starten, und `Wait-PSUJob`, um auf ihn zu warten. Verwenden Sie außerhalb von PowerShell Universal ein gültiges App-Token. ```powershell Invoke-PSUScript -Script 'Script1.ps1' -RequiredParameter 'Hello' | Wait-PSUJob ``` Rufen Sie die Pipeline-Ausgabe mit `Get-PSUJobPipelineOutput` ab. ```powershell Get-PSUJobPipelineOutput -JobId 10 ``` Verwenden Sie `-Integrated` nur innerhalb von PowerShell Universal. Apps können es mit `-Wait` verwenden, um `Write-Progress`- und `Read-Host`-Interaktionen weiterzuleiten. ```powershell New-UDButton -Text 'Run script' -OnClick { Invoke-PSUScript -Name 'AppExample.ps1' -Integrated -Wait } -ShowLoading ``` ## Job Run ID Standardmäßig verwenden Jobs aufsteigende numerische IDs. Aktivieren Sie `JobRunID`, um eine GUID-basierte `RunID` für Job-Abfragen zu verwenden. ```powershell Set-PSUSetting -JobRunId ``` ## API * `Invoke-PSUScript` * `Get-PSUJob` * `Get-PSUJobOutput` * `Get-PSUJobPipelineOutput` * `Wait-PSUJob` --- # 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/automatisierung/jobs.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.