> 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/it/comandi-powershell/set-psusetting.md).

# Set-PSUSetting

Set-PSUSetting configura le impostazioni del server PowerShell Universal, coprendo logging, sicurezza, sessioni, limiti di frequenza, branding e la console di amministrazione.

## SINOSSI

Configura le impostazioni del server PowerShell Universal.

## SINTASSI

Tutte le opzioni sono facoltative. Specifichi solo le impostazioni che desidera modificare:

```powershell
Set-PSUSetting [-LogLevel <String>] [-MicrosoftLogLevel <String>] [-LoggingFilePath <String>] [-DefaultEnvironment <String>] [-GroomDays <Int32>] [-ConcurrentJobLimit <Int32>] [-Telemetry] [-HideApi] [-HideHomePage] [-HideAutomation] [-HideDashboard] [-DisableCodeFirst] [-SecurityEnvironment <String>] [-ApiEnvironment <String>] [-DefaultPage <String>] [-RateLimitClientAllowList <String[]>] [-RateLimitIpAddressAllowList <String[]>] [-RateLimitEndpointAllowList <String[]>] [-DisableUpdateCheck] [-ScriptBaseFolder <String>] [-AdminConsoleLogo <String>] [-AdminConsoleTitle <String>] [-GroomInterval <Int32>] [-NotificationLevel <NotificationLevel>] [-ProxyUri <String>] [-ProxyCredential <Variable>] [-JobHandshakeTimeout <Int32>] [-HideRunAs] [-FallbackLanguageId <String>] [-Splatting] [-FavIcon <String>] [-ExperimentalFeatures <ExperimentalFeatures>] [-DisabledFeatures <Features>] [-LimitIdentities] [-DontLoadProfile] [-EnhancedAppTokenSecurity] [-DefaultDashboardTheme <String>] [-UseLogoSize] [-DarkTheme] [-HideEnvironment] [-HideRunOn] [-DisableFormatOnSave] [-ContentSecurityPolicy <String>] [-LogGroomDays <Int32>] [-Branding <OldBranding>] [-PreformattedJobOutput] [-ModuleDiscoveryFrequency <String>] [-DebuggerEnvironment <String>] [-FileEncoding <String>] [-MaxJobMemory <Int32>] [-LargeJobOutputBehavior <LargeJobOutputBehavior>] [-MaxJobOutputSizeKB <Int32>] [-JobRunId] [-ApiBaseFolder <String>] [-AbandonedJobGroomDays <Int32>] [-CheckForModuleUpdates] [-DisableRequiredModuleInstallation] [-HideRunLater] [-AnonymousApiDocumentation] [-MaximumTokenLifetime <Int32>] [-PortalDisabled] [-PortalRole <String[]>] [-DefaultTokenLifetime <Int32>] [-ApiSecurityModel <ApiSecurityModel>] [-DefaultRunOn <String>] [-SessionTimeout <Int32>] [-DisableFirstRun] [-DebugPreference <ActionPreference>] [-VerbosePreference <ActionPreference>] [-InformationPreference <ActionPreference>] [-WarningPreference <ActionPreference>] [-ErrorPreference <ActionPreference>] [-ProgressPreference <ActionPreference>] [-DisableDatabaseVault] [-PasswordExpirationDays <Int32>] [-PasswordLength <Int32>] [-DisableDevolutionsAccountLogin] [-RedactSensitiveJobOutput] [-SensitiveJobOutputKeys <String[]>] [-McpToolRateLimitPerMinute <Int32>] [-McpToolConcurrentJobLimit <Int32>] [<ConnectionOptions>] [<CommonParameters>]
```

`<ConnectionOptions>`: `[-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]`.

## DESCRIZIONE

Aggiorna le impostazioni del server. Quando viene chiamato su un'istanza in esecuzione, cambiano solo le impostazioni indicate in modo esplicito; l'uso di un file di configurazione crea un oggetto di impostazioni. I controlli dell'output dei job includono `-LargeJobOutputBehavior`, `-MaxJobOutputSizeKB`, `-PreformattedJobOutput` e `-JobRunId`. `-RedactSensitiveJobOutput` è facoltativo e disattivato per impostazione predefinita; quando è abilitato, PSU maschera i valori delle chiavi sensibili predefinite nell'output JSON comune, di modulo o di stringa di query, e `key: value`, prima di renderlo persistente o di visualizzarlo. `-SensitiveJobOutputKeys` aggiunge chiavi da mascherare. Il mascheramento è un tentativo ragionevole, non un analizzatore completo di segreti. I controlli degli strumenti MCP includono `-McpToolConcurrentJobLimit` e `-McpToolRateLimitPerMinute`.

## ESEMPIO

```powershell
Set-PSUSetting -RedactSensitiveJobOutput -SensitiveJobOutputKeys 'tenant_secret','service_token' -LargeJobOutputBehavior Compress -MaxJobOutputSizeKB 10240
```

## PARAMETRI

### Registrazione ed esecuzione

| Parametro                            | Descrizione                                                                                                                        |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| `-LogLevel`                          | Livello di registrazione PSU; quando viene aggiornato in fase di esecuzione, aggiorna anche il livello di registrazione Microsoft. |
| `-MicrosoftLogLevel`                 | Livello di registrazione del framework Microsoft in modalità file di configurazione.                                               |
| `-LoggingFilePath`                   | Percorso del file di registro.                                                                                                     |
| `-DefaultEnvironment`                | Ambiente di esecuzione di PowerShell predefinito.                                                                                  |
| `-GroomDays`                         | Periodo di conservazione in giorni dei record ripuliti; 30 per impostazione predefinita.                                           |
| `-ConcurrentJobLimit`                | Numero massimo di job simultanei; 1000 per impostazione predefinita.                                                               |
| `-Telemetry`                         | Abilita la telemetria.                                                                                                             |
| `-SecurityEnvironment`               | Ambiente per i processi di sicurezza.                                                                                              |
| `-ApiEnvironment`                    | Ambiente di esecuzione API predefinito.                                                                                            |
| `-ScriptBaseFolder`                  | Cartella radice degli script.                                                                                                      |
| `-GroomInterval`                     | Intervallo di pulizia; 1 per impostazione predefinita.                                                                             |
| `-NotificationLevel`                 | Livello di gravità delle notifiche.                                                                                                |
| `-ProxyUri`                          | URI del proxy in uscita.                                                                                                           |
| `-ProxyCredential`                   | Variabile PSU che contiene la credenziale del proxy.                                                                               |
| `-JobHandshakeTimeout`               | Timeout dell'handshake del job; 30 per impostazione predefinita.                                                                   |
| `-Splatting`                         | Abilita lo splatting dei parametri nelle impostazioni di esecuzione.                                                               |
| `-DontLoadProfile`                   | Ignora il caricamento dei profili di PowerShell.                                                                                   |
| `-LogGroomDays`                      | Periodo di conservazione dei registri in giorni; 7 per impostazione predefinita.                                                   |
| `-ModuleDiscoveryFrequency`          | Espressione cron che controlla l'individuazione dei moduli; per impostazione predefinita, `*/15 * * * *`.                          |
| `-DebuggerEnvironment`               | Ambiente di esecuzione del debugger.                                                                                               |
| `-FileEncoding`                      | Codifica usata per i file.                                                                                                         |
| `-MaxJobMemory`                      | Impostazione della memoria massima dei job.                                                                                        |
| `-LargeJobOutputBehavior`            | Gestione dell'output dei job di dimensioni eccessive; `Warn` per impostazione predefinita.                                         |
| `-MaxJobOutputSizeKB`                | Dimensione massima dell'output dei job in KB; 10240 per impostazione predefinita.                                                  |
| `-JobRunId`                          | Abilita gli ID di esecuzione dei job.                                                                                              |
| `-ApiBaseFolder`                     | Cartella radice degli endpoint API.                                                                                                |
| `-AbandonedJobGroomDays`             | Giorni di conservazione dei job abbandonati; 7 per impostazione predefinita.                                                       |
| `-CheckForModuleUpdates`             | Controlla se i moduli installati hanno aggiornamenti.                                                                              |
| `-DisableRequiredModuleInstallation` | Disabilita l'installazione automatica dei moduli necessari.                                                                        |
| `-PreformattedJobOutput`             | Archivia o presenta l'output del job in forma preformattata.                                                                       |
| `-RedactSensitiveJobOutput`          | Abilita il mascheramento ragionevole dell'output sensibile dei job (disattivato per impostazione predefinita).                     |
| `-SensitiveJobOutputKeys`            | Nomi di chiavi aggiuntivi i cui valori devono essere mascherati nell'output del job.                                               |
| `-McpToolRateLimitPerMinute`         | Numero massimo di chiamate agli strumenti MCP consentite al minuto.                                                                |
| `-McpToolConcurrentJobLimit`         | Numero massimo di job simultanei avviati dagli strumenti MCP.                                                                      |

### Console, app e interfaccia

| Parametro                | Descrizione                                                                     |
| ------------------------ | ------------------------------------------------------------------------------- |
| `-HideApi`               | Nasconde la navigazione delle API nella console.                                |
| `-HideHomePage`          | Nasconde la pagina iniziale.                                                    |
| `-HideAutomation`        | Nasconde la navigazione dell'automazione nella console.                         |
| `-HideDashboard`         | Nasconde la navigazione di app e dashboard nella console.                       |
| `-DisableCodeFirst`      | Disabilita il ricaricamento automatico code-first (alias `-DisableAutoReload`). |
| `-DefaultPage`           | Pagina della console predefinita.                                               |
| `-DisableUpdateCheck`    | Disabilita il controllo degli aggiornamenti.                                    |
| `-AdminConsoleLogo`      | Logo della console di amministrazione.                                          |
| `-AdminConsoleTitle`     | Titolo della console di amministrazione.                                        |
| `-HideRunAs`             | Nasconde i controlli Esegui come.                                               |
| `-FallbackLanguageId`    | ID lingua di fallback; `en` per impostazione predefinita.                       |
| `-FavIcon`               | Favicon.                                                                        |
| `-ExperimentalFeatures`  | Funzionalità sperimentali da abilitare.                                         |
| `-DisabledFeatures`      | Funzionalità da disabilitare.                                                   |
| `-DefaultDashboardTheme` | Tema dell'app predefinito; `AntDesign` per impostazione predefinita.            |
| `-UseLogoSize`           | Applica le dimensioni del logo configurate.                                     |
| `-DarkTheme`             | Abilita il tema scuro.                                                          |
| `-HideEnvironment`       | Nasconde i controlli dell'ambiente di esecuzione.                               |
| `-HideRunOn`             | Nasconde i controlli Esegui su.                                                 |
| `-DisableFormatOnSave`   | Disabilita la formattazione degli script al salvataggio.                        |
| `-Branding`              | Oggetto di configurazione del branding legacy.                                  |
| `-HideRunLater`          | Nasconde i controlli Esegui più tardi.                                          |
| `-PortalDisabled`        | Disabilita il portale.                                                          |
| `-PortalRole`            | Ruoli autorizzati ad accedere al portale.                                       |
| `-DefaultRunOn`          | Destinazione di esecuzione predefinita.                                         |
| `-DisableFirstRun`       | Disabilita il flusso di prima esecuzione.                                       |

### Sicurezza, token e API

| Parametro                         | Descrizione                                                                    |
| --------------------------------- | ------------------------------------------------------------------------------ |
| `-RateLimitClientAllowList`       | Identificatori client esenti dai limiti di frequenza.                          |
| `-RateLimitIpAddressAllowList`    | Indirizzi IP esenti dai limiti di frequenza.                                   |
| `-RateLimitEndpointAllowList`     | Percorsi di endpoint esenti dai limiti di frequenza.                           |
| `-ContentSecurityPolicy`          | Valore della Content Security Policy.                                          |
| `-LimitIdentities`                | Limita l'uso delle identità in base alle impostazioni del server.              |
| `-EnhancedAppTokenSecurity`       | Abilita la sicurezza avanzata dei token dell'app.                              |
| `-AnonymousApiDocumentation`      | Consente l'accesso non autenticato alla documentazione dell'API.               |
| `-MaximumTokenLifetime`           | Impostazione della durata massima del token dell'app.                          |
| `-DefaultTokenLifetime`           | Durata predefinita del token dell'app; 30 per impostazione predefinita.        |
| `-ApiSecurityModel`               | Modello di sicurezza delle richieste API.                                      |
| `-SessionTimeout`                 | Timeout di sessione; 25 per impostazione predefinita.                          |
| `-DisableDatabaseVault`           | Disabilita l'archivio dei segreti supportato dal database.                     |
| `-PasswordExpirationDays`         | Periodo di scadenza della password in giorni; 90 per impostazione predefinita. |
| `-PasswordLength`                 | Lunghezza della password obbligatoria; 12 per impostazione predefinita.        |
| `-DisableDevolutionsAccountLogin` | Disabilita l'accesso con Devolutions Account.                                  |

### Preferenze e connessione di gestione

| Parametro                | Descrizione                                                   |
| ------------------------ | ------------------------------------------------------------- |
| `-DebugPreference`       | Preferenza di azione predefinita per l'output di debug.       |
| `-VerbosePreference`     | Preferenza di azione predefinita per l'output dettagliato.    |
| `-InformationPreference` | Preferenza di azione predefinita per l'output informativo.    |
| `-WarningPreference`     | Preferenza di azione predefinita per gli avvisi.              |
| `-ErrorPreference`       | Preferenza di azione predefinita per gli errori.              |
| `-ProgressPreference`    | Preferenza di azione predefinita per l'output di avanzamento. |
| `-ComputerName`          | URL o nome host dell'API di gestione PSU (alias `-Uri`).      |
| `-AppToken`              | Token dell'app dell'API di gestione.                          |
| `-Credential`            | Credenziali dell'API di gestione.                             |
| `-UseDefaultCredentials` | Usa le credenziali Windows correnti.                          |
| `-Integrated`            | Usa il client di gestione nel processo.                       |
| `-TrustCertificate`      | Ignora gli errori di convalida del certificato.               |
| `-Cookies`               | Riutilizza i cookie di autenticazione della sessione.         |

## AUTORIZZAZIONI

Il token di accesso richiede `settings.general/update` per eseguire questo cmdlet in remoto.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/it/comandi-powershell/set-psusetting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.