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

# Set-PSUSetting

Set-PSUSetting konfiguriert die Servereinstellungen von PowerShell Universal und deckt Protokollierung, Sicherheit, Sitzungen, Ratenbegrenzungen, Branding und die Admin-Konsole ab.

## SYNOPSIS

Konfiguriert die Servereinstellungen von PowerShell Universal.

## SYNTAX

Alle Optionen sind optional. Geben Sie nur die Einstellungen an, die Sie ändern möchten:

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

## BESCHREIBUNG

Aktualisiert Servereinstellungen. Bei einem Aufruf für eine laufende Instanz werden nur explizit angegebene Einstellungen geändert; die Verwendung einer Konfigurationsdatei erstellt ein Einstellungsobjekt. Steuerelemente für die Jobausgabe umfassen `-LargeJobOutputBehavior`, `-MaxJobOutputSizeKB`, `-PreformattedJobOutput` und `-JobRunId`. `-RedactSensitiveJobOutput` ist optional und standardmäßig deaktiviert; wenn es aktiviert ist, maskiert PSU Werte für integrierte vertrauliche Schlüssel in gängiger JSON-, Formular-/Abfragezeichenfolgen- und `key: value`-Ausgabe, bevor sie gespeichert oder angezeigt wird. `-SensitiveJobOutputKeys` fügt Schlüssel hinzu, die geschwärzt werden. Die Schwärzung ist ein Best-Effort-Verfahren und kein vollständiger Geheimnisscanner. Steuerelemente für MCP-Tools umfassen `-McpToolConcurrentJobLimit` und `-McpToolRateLimitPerMinute`.

## BEISPIEL

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

## PARAMETER

### Protokollierung und Ausführung

| Parameter                            | Beschreibung                                                                                                                 |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `-LogLevel`                          | PSU-Protokollierungsstufe; bei einer Aktualisierung zur Laufzeit wird auch die Microsoft-Protokollierungsstufe aktualisiert. |
| `-MicrosoftLogLevel`                 | Protokollierungsstufe des Microsoft-Frameworks im Konfigurationsdateimodus.                                                  |
| `-LoggingFilePath`                   | Pfad der Protokolldatei.                                                                                                     |
| `-DefaultEnvironment`                | Standardmäßige PowerShell-Ausführungsumgebung.                                                                               |
| `-GroomDays`                         | Aufbewahrungszeitraum bereinigter Datensätze in Tagen; standardmäßig 30.                                                     |
| `-ConcurrentJobLimit`                | Maximale Anzahl gleichzeitiger Jobs; standardmäßig 1000.                                                                     |
| `-Telemetry`                         | Aktiviert die Telemetrie.                                                                                                    |
| `-SecurityEnvironment`               | Umgebung für Sicherheitsprozesse.                                                                                            |
| `-ApiEnvironment`                    | Standardmäßige API-Ausführungsumgebung.                                                                                      |
| `-ScriptBaseFolder`                  | Stammordner für Skripts.                                                                                                     |
| `-GroomInterval`                     | Bereinigungsintervall; standardmäßig 1.                                                                                      |
| `-NotificationLevel`                 | Schweregrad der Benachrichtigungen.                                                                                          |
| `-ProxyUri`                          | URI für den ausgehenden Proxy.                                                                                               |
| `-ProxyCredential`                   | PSU-Variable, die die Proxyanmeldeinformation enthält.                                                                       |
| `-JobHandshakeTimeout`               | Timeout für den Job-Handshake; standardmäßig 30.                                                                             |
| `-Splatting`                         | Aktiviert das Parameter-Splatting in den Ausführungseinstellungen.                                                           |
| `-DontLoadProfile`                   | Überspringt das Laden von PowerShell-Profilen.                                                                               |
| `-LogGroomDays`                      | Aufbewahrungszeitraum der Protokolle in Tagen; standardmäßig 7.                                                              |
| `-ModuleDiscoveryFrequency`          | Cron-Ausdruck, der die Modulerkennung steuert; standardmäßig `*/15 * * * *`.                                                 |
| `-DebuggerEnvironment`               | Ausführungsumgebung für den Debugger.                                                                                        |
| `-FileEncoding`                      | Für Dateien verwendete Codierung.                                                                                            |
| `-MaxJobMemory`                      | Einstellung für den maximalen Arbeitsspeicher von Jobs.                                                                      |
| `-LargeJobOutputBehavior`            | Behandlung übergroßer Jobausgabe; standardmäßig `Warn`.                                                                      |
| `-MaxJobOutputSizeKB`                | Maximale Größe der Jobausgabe in KB; standardmäßig 10240.                                                                    |
| `-JobRunId`                          | Aktiviert Job-Ausführungs-IDs.                                                                                               |
| `-ApiBaseFolder`                     | Stammordner für API-Endpunkte.                                                                                               |
| `-AbandonedJobGroomDays`             | Tage, für die aufgegebene Jobs aufbewahrt werden; standardmäßig 7.                                                           |
| `-CheckForModuleUpdates`             | Prüft installierte Module auf Updates.                                                                                       |
| `-DisableRequiredModuleInstallation` | Deaktiviert die automatische Installation erforderlicher Module.                                                             |
| `-PreformattedJobOutput`             | Speichert oder zeigt die Jobausgabe in vorformatierter Form.                                                                 |
| `-RedactSensitiveJobOutput`          | Aktiviert die bestmögliche Maskierung vertraulicher Jobausgabe (standardmäßig deaktiviert).                                  |
| `-SensitiveJobOutputKeys`            | Zusätzliche Schlüsselnamen, deren Werte in der Jobausgabe maskiert werden sollen.                                            |
| `-McpToolRateLimitPerMinute`         | Maximal zulässige MCP-Toolaufrufe pro Minute.                                                                                |
| `-McpToolConcurrentJobLimit`         | Maximale Anzahl gleichzeitiger Jobs, die von MCP-Tools gestartet werden.                                                     |

### Konsole, Apps und Oberfläche

| Parameter                | Beschreibung                                                                       |
| ------------------------ | ---------------------------------------------------------------------------------- |
| `-HideApi`               | Blendet die API-Navigation in der Konsole aus.                                     |
| `-HideHomePage`          | Blendet die Startseite aus.                                                        |
| `-HideAutomation`        | Blendet die Automatisierungsnavigation in der Konsole aus.                         |
| `-HideDashboard`         | Blendet die Navigation für Apps und Dashboards in der Konsole aus.                 |
| `-DisableCodeFirst`      | Deaktiviert das automatische Neuladen für Code-First (Alias `-DisableAutoReload`). |
| `-DefaultPage`           | Standardseite der Konsole.                                                         |
| `-DisableUpdateCheck`    | Deaktiviert die Updateprüfung.                                                     |
| `-AdminConsoleLogo`      | Logo der Verwaltungskonsole.                                                       |
| `-AdminConsoleTitle`     | Titel der Verwaltungskonsole.                                                      |
| `-HideRunAs`             | Blendet die Steuerelemente für Ausführen als aus.                                  |
| `-FallbackLanguageId`    | Fallback-Sprach-ID; standardmäßig `en`.                                            |
| `-FavIcon`               | Favicon.                                                                           |
| `-ExperimentalFeatures`  | Zu aktivierende experimentelle Features.                                           |
| `-DisabledFeatures`      | Zu deaktivierende Features.                                                        |
| `-DefaultDashboardTheme` | Standardmäßiges App-Design; standardmäßig `AntDesign`.                             |
| `-UseLogoSize`           | Wendet die konfigurierte Logogröße an.                                             |
| `-DarkTheme`             | Aktiviert das dunkle Design.                                                       |
| `-HideEnvironment`       | Blendet die Steuerelemente der Ausführungsumgebung aus.                            |
| `-HideRunOn`             | Blendet die Steuerelemente für Ausführen auf aus.                                  |
| `-DisableFormatOnSave`   | Deaktiviert das Formatieren von Skripts beim Speichern.                            |
| `-Branding`              | Älteres Branding-Konfigurationsobjekt.                                             |
| `-HideRunLater`          | Blendet die Steuerelemente für Später ausführen aus.                               |
| `-PortalDisabled`        | Deaktiviert das Portal.                                                            |
| `-PortalRole`            | Rollen, die auf das Portal zugreifen dürfen.                                       |
| `-DefaultRunOn`          | Standardmäßiges Ausführungsziel.                                                   |
| `-DisableFirstRun`       | Deaktiviert den Ablauf beim ersten Start.                                          |

### Sicherheit, Token und API

| Parameter                         | Beschreibung                                                               |
| --------------------------------- | -------------------------------------------------------------------------- |
| `-RateLimitClientAllowList`       | Clientkennungen, die von Ratenbegrenzungen ausgenommen sind.               |
| `-RateLimitIpAddressAllowList`    | IP-Adressen, die von Ratenbegrenzungen ausgenommen sind.                   |
| `-RateLimitEndpointAllowList`     | Endpunktpfade, die von Ratenbegrenzungen ausgenommen sind.                 |
| `-ContentSecurityPolicy`          | Wert der Content Security Policy.                                          |
| `-LimitIdentities`                | Schränkt die Verwendung von Identitäten gemäß den Servereinstellungen ein. |
| `-EnhancedAppTokenSecurity`       | Aktiviert die erweiterte Sicherheit für App-Token.                         |
| `-AnonymousApiDocumentation`      | Nicht authentifizierten Zugriff auf die API-Dokumentation zulassen.        |
| `-MaximumTokenLifetime`           | Einstellung für die maximale Lebensdauer von App-Token.                    |
| `-DefaultTokenLifetime`           | Standardmäßige Lebensdauer von App-Token; standardmäßig 30.                |
| `-ApiSecurityModel`               | Sicherheitsmodell für API-Anforderungen.                                   |
| `-SessionTimeout`                 | Sitzungstimeout; standardmäßig 25.                                         |
| `-DisableDatabaseVault`           | Deaktiviert den datenbankgestützten Geheimnistresor.                       |
| `-PasswordExpirationDays`         | Ablaufzeitraum des Kennworts in Tagen; standardmäßig 90.                   |
| `-PasswordLength`                 | Erforderliche Kennwortlänge; standardmäßig 12.                             |
| `-DisableDevolutionsAccountLogin` | Deaktiviert die Anmeldung mit Devolutions Account.                         |

### Einstellungen und Verwaltungsverbindung

| Parameter                | Beschreibung                                                   |
| ------------------------ | -------------------------------------------------------------- |
| `-DebugPreference`       | Standardmäßige Aktionsvoreinstellung für Debugausgabe.         |
| `-VerbosePreference`     | Standardmäßige Aktionsvoreinstellung für ausführliche Ausgabe. |
| `-InformationPreference` | Standardmäßige Aktionsvoreinstellung für Informationsausgabe.  |
| `-WarningPreference`     | Standardmäßige Aktionsvoreinstellung für Warnungen.            |
| `-ErrorPreference`       | Standardmäßige Aktionsvoreinstellung für Fehler.               |
| `-ProgressPreference`    | Standardmäßige Aktionsvoreinstellung für Fortschrittsausgabe.  |
| `-ComputerName`          | URL oder Hostname der PSU-Verwaltungs-API (Alias `-Uri`).      |
| `-AppToken`              | App-Token der Verwaltungs-API.                                 |
| `-Credential`            | Anmeldeinformationen der Verwaltungs-API.                      |
| `-UseDefaultCredentials` | Verwendet die aktuellen Windows-Anmeldeinformationen.          |
| `-Integrated`            | Verwendet den prozessinternen Verwaltungsclient.               |
| `-TrustCertificate`      | Ignoriert Fehler bei der Zertifikatsvalidierung.               |
| `-Cookies`               | Verwendet die Authentifizierungscookies der Sitzung erneut.    |

## BERECHTIGUNGEN

Das Zugriffstoken erfordert `settings.general/update`, um dieses Cmdlet remote auszuführen.


---

# 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/de/powershell-befehle/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.