> 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/it/knowledge-base/troubleshooting-articles/action-scripts-troubleshoot-in-devolutions-server.md).

# Risoluzione dei problemi degli script di azione in Devolutions Server

Quando gli [script di azione](/pam/it/knowledge-base/knowledge-base-articles/custom-pam-provider-action-scripts-in-devolutions-server.md) non funzionano all'interno dei provider PAM personalizzati, è essenziale sapere come identificare e risolvere il problema. Con un provider PAM personalizzato possono verificarsi molteplici problemi, a causa dei diversi passaggi coinvolti. Inoltre, i provider PAM personalizzati dipendono fortemente dagli script di azione per il loro funzionamento e, a seconda della complessità del provider di identità, questi script di azione possono diventare complessi.

Possono verificarsi problemi se il provider non viene testato accuratamente in anticipo. Le seguenti linee guida aiuteranno a identificare i potenziali problemi e forniranno i passaggi per la risoluzione.

### 1. Identificare il problema

Il problema potrebbe non essere sempre immediatamente evidente. Sebbene gli script di azione possano funzionare correttamente in modo isolato, i provider PAM personalizzati potrebbero non applicare le modifiche delle password come previsto. Ad esempio, se gli script di azione sono costruiti in modo errato e restituiscono informazioni inesatte, i provider PAM personalizzati potrebbero utilizzare tali informazioni per prendere decisioni, presumendo che tutto funzioni correttamente quando non è così.

In alcuni casi, il problema può essere più evidente, ad esempio la comparsa di un messaggio di avviso "Out of sync" per l'utente nella cassaforte Devolutions PAM o il rilevamento di un problema nei [log PAM](/pam/it/pam-with-devolutions-server/pam-reports-in-devolutions-server.md).

### 2. Identificare lo script di azione coinvolto

Poiché i provider PAM personalizzati funzionano principalmente come orchestratori di script, la maggior parte delle loro funzionalità dipende dagli script di azione. Se compare un errore nella console di Devolutions Server, è importante innanzitutto identificare quale script di azione è coinvolto. Ciò richiede la comprensione di come i provider PAM personalizzati *associano* le funzionalità agli script di azione attraverso la loro terminologia.

* Configurazione del rilevamento degli account: le configurazioni di rilevamento degli account utilizzano lo script di azione di rilevamento degli account.
* Sincronizzazione: i provider PAM personalizzati utilizzano il termine "sincronizzazione" per riferirsi all'esecuzione dello script di azione heartbeat.
* Reimpostazione della password: l'avvio di una reimpostazione della password nei provider PAM personalizzati coinvolge sia lo script di azione di rotazione della password sia quello heartbeat.

### 3. Testare gli script di azione al di fuori dei provider PAM personalizzati.

Dopo aver identificato gli script di azione coinvolti, è consigliabile testarli al di fuori dei provider PAM personalizzati per assicurarsi che il problema non abbia origine dallo script di azione stesso. Allo script devono essere passati gli stessi parametri definiti tramite Script Parameters durante la creazione del modello. È fondamentale verificare che lo script PowerShell restituisca i risultati attesi per i provider PAM personalizzati:

* Rilevamento degli account: deve restituire in output almeno un oggetto `pscustomobject` con le proprietà `id`, `username` e `secret`.
* Heartbeat: deve avere i parametri `username` e `secret` e restituire un singolo valore booleano, `$true` oppure `$false`.
* Rotazione della password: deve includere i parametri per l'endpoint del provider di identità, il nome utente dell'endpoint, la password dell'endpoint e un parametro con il nome specifico `NewPassword`.


---

# 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/it/knowledge-base/troubleshooting-articles/action-scripts-troubleshoot-in-devolutions-server.md?ask=<question>&goal=<endgoal>
```

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