> 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/pam/de/knowledge-base/troubleshooting-articles/action-scripts-troubleshoot-in-devolutions-server.md). # Fehlerbehebung bei Aktionsskripten in Devolutions Server Wenn [Aktionsskripte](/pam/de/knowledge-base/knowledge-base-articles/custom-pam-provider-action-scripts-in-devolutions-server.md) innerhalb benutzerdefinierter PAM-Anbieter fehlschlagen, ist es wichtig zu verstehen, wie das Problem identifiziert und behoben werden kann. Aufgrund der verschiedenen beteiligten Schritte können bei einem benutzerdefinierten PAM-Anbieter mehrere Probleme auftreten. Zudem verlassen sich benutzerdefinierte PAM-Anbieter für ihre Funktionalität stark auf Aktionsskripte, und je nach Komplexität des Identitätsanbieters können diese Aktionsskripte sehr komplex werden. Probleme können auftreten, wenn der Anbieter nicht vorher gründlich getestet wurde. Die folgenden Richtlinien helfen dabei, mögliche Probleme zu identifizieren, und bieten Schritte zur Fehlerbehebung. ### 1. Das Problem identifizieren Das Problem ist nicht immer sofort ersichtlich. Während die Aktionsskripte isoliert betrachtet korrekt funktionieren können, wenden benutzerdefinierte PAM-Anbieter Passwortänderungen möglicherweise nicht wie erwartet an. Wenn die Aktionsskripte beispielsweise falsch aufgebaut sind und ungenaue Informationen zurückgeben, verwenden benutzerdefinierte PAM-Anbieter diese Informationen möglicherweise, um Entscheidungen zu treffen, und gehen davon aus, dass alles ordnungsgemäß funktioniert, obwohl dies nicht der Fall ist. In manchen Fällen ist das Problem offensichtlicher, etwa wenn eine Warnmeldung "Out of sync" für den Benutzer im Devolutions PAM-Tresor erscheint oder ein Problem in den [PAM-Protokollen](/pam/de/pam-with-devolutions-server/pam-reports-in-devolutions-server.md) auffällt. ### 2. Das beteiligte Aktionsskript identifizieren Da benutzerdefinierte PAM-Anbieter hauptsächlich als Skript-Orchestrator arbeiten, hängt der Großteil ihrer Funktionalität von den Aktionsskripten ab. Wenn in der Devolutions Server-Konsole ein Fehler erscheint, ist es wichtig, zuerst zu identifizieren, welches Aktionsskript beteiligt ist. Dazu muss man verstehen, wie benutzerdefinierte PAM-Anbieter Funktionalität über ihre Terminologie den Aktionsskripten *zuordnen*. * Konfiguration der Kontoerkennung: Konfigurationen der Kontoerkennung verwenden das Aktionsskript für die Kontoerkennung. * Synchronisierung: Benutzerdefinierte PAM-Anbieter verwenden den Begriff "Synchronisierung", um auf die Ausführung des Heartbeat-Aktionsskripts zu verweisen. * Passwort-Zurücksetzung: Das Initiieren einer Passwort-Zurücksetzung in benutzerdefinierten PAM-Anbietern umfasst sowohl das Aktionsskript für die Passwortrotation als auch das Heartbeat-Aktionsskript. ### 3. Aktionsskripte außerhalb benutzerdefinierter PAM-Anbieter testen. Nachdem die beteiligten Aktionsskripte identifiziert wurden, ist es ratsam, sie außerhalb benutzerdefinierter PAM-Anbieter zu testen, um sicherzustellen, dass das Problem nicht vom Aktionsskript selbst ausgeht. Dieselben Parameter, die beim Erstellen der Vorlage über Skriptparameter definiert wurden, sollten an das Skript übergeben werden. Es ist entscheidend zu überprüfen, ob das PowerShell-Skript die von benutzerdefinierten PAM-Anbietern erwarteten Ergebnisse zurückgibt: * Kontoerkennung: Sollte mindestens ein `pscustomobject`-Objekt mit den Eigenschaften `id`, `username` und `secret` ausgeben. * Heartbeat: Sollte die Parameter `username` und `secret` haben und einen einzelnen booleschen Wert zurückgeben, entweder `$true` oder `$false`. * Passwortrotation: Sollte Parameter für den Endpunkt des Identitätsanbieters, den Endpunkt-Benutzernamen, das Endpunkt-Passwort und einen speziell benannten Parameter namens `NewPassword` enthalten. --- # 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/pam/de/knowledge-base/troubleshooting-articles/action-scripts-troubleshoot-in-devolutions-server.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.