> 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-psubranding.md). # Set-PSUBranding Set-PSUBranding passt Branding, Farben und Logos von Portal, Anmeldeseite und Admin-Konsole für eine PowerShell Universal-Bereitstellung an. ## ÜBERSICHT Legt das Branding für PowerShell Universal fest. ## SYNTAX ``` Set-PSUBranding [-LoginPageImage ] [-AppBarLogo ] [-AdminConsoleTitle ] [-LoginPageTitle ] [-LoginPageText ] [-LoginPageDescription ] [-PrimaryColor ] [-SecondaryColor ] [-PrimaryFontColor ] [-SecondaryFontColor ] [-HeaderFontColor ] [-HeaderColor ] [-Copyright ] [-LoginPageLinks ] [-CssStylesheet ] [-CssStylesheetIntegrity ] [-PageNotFoundDescription ] [-NotAuthorizedDescription ] [-AppNotRunningDescription ] [-PageNotFoundTitle ] [-NotAuthorizedTitle ] [-LoggedOut ] [-LoggedOutDescription ] [-Favicon ] [-DarkAppBarLogo ] [-PortalTitle ] [-LoginPageTheme ] [-LoginPageCssStylesheet ] [-LoginPageLayout ] [-LoginPageBackgroundColor ] [-LoginPageLogoSize ] [-LoginPageFontColor ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## BESCHREIBUNG Aktualisiert die Branding-Einstellungen von Portal, Anmeldeseite und Admin-Konsole für PowerShell Universal. `New-PSUBranding` und `New-PSULoginPage` sind Aliase dieses Cmdlets. Jeder Aufruf ersetzt die Branding-Definition, anstatt nur die angegebenen Parameter zusammenzuführen. Schließen Sie alle Einstellungen ein, die Sie beibehalten möchten. Bei der Auswertung in `.universal\branding.ps1` erzeugt das Cmdlet das Konfigurationsobjekt, das PSU lädt. Außerhalb des Konfigurationsladens wendet es die Definition auf den verbundenen Server an und gibt sie zurück. Siehe [Branding](/powershell-universal/de/config/login-page.md) für vollständige Beispiele, das Hosten öffentlicher Assets, Anmeldelayouts, Farben, CSS, Fehlermeldungen und Kompatibilitätshinweise. ## BEISPIELE ### Beispiel 1: Logos und Konsolentitel festlegen ```powershell Set-PSUBranding -LoginPageImage '/branding/logo.png' -AppBarLogo '/branding/logo.png' -AdminConsoleTitle 'My Admin Console' ``` Legt das Anmeldebild, das Navigationslogo und das Browser-Titelsuffix der Admin-Konsole fest. Veröffentlichen Sie das Bild zuerst unter der angegebenen URL. Bildparameter akzeptieren URLs, die der Browser erreichen kann, keine Dateisystempfade des Servers. Vor der Anmeldung benötigte Assets müssen anonymen Zugriff zulassen. Dieser Aufruf ersetzt jede vorhandene Branding-Definition. ### Beispiel 2: Ein vollständiges Branding-Profil beibehalten ```powershell $branding = @{ AdminConsoleTitle = 'Contoso Automation' PortalTitle = 'Contoso Self-Service' LoginPageTitle = 'Contoso Automation' LoginPageText = 'Sign in with your work account' LoginPageDescription = 'Automation for Contoso employees.' LoginPageImage = '/branding/logo.png' AppBarLogo = '/branding/logo.png' DarkAppBarLogo = '/branding/logo-on-dark.png' Favicon = '/branding/favicon.ico' LoginPageLogoSize = '180px' LoginPageTheme = 'Light' LoginPageLayout = 'Horizontal' } Set-PSUBranding @branding ``` Hält zusammengehörige Einstellungen beisammen, damit das Anwenden des Profils frühere Werte nicht auslässt. Verwenden Sie `System`, `Light` oder `Dark` für das Design und `Vertical` oder `Horizontal` für das Layout. ## PARAMETER ### -AdminConsoleTitle Das Browser-Titelsuffix der Admin-Konsole. Eine Entwicklerlizenz verwendet stattdessen den Entwicklungstitel. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppBarLogo Die URL des regulären Logos für die integrierte Navigation von Konsole und Portal. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppNotRunningDescription Der Text, der auf dem Bildschirm „App wird nicht ausgeführt“ des App-Frameworks angezeigt wird, nicht auf dem Start- oder Ladebildschirm des Servers. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppToken Das AppToken, das für Aufrufe der PowerShell Universal Management API verwendet wird. Sie können Connect-PSUServer auch aufrufen, bevor Sie dieses Cmdlet verwenden, um das AppToken für die gesamte Sitzung festzulegen. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Gibt den Computernamen oder die URL an, die beim Zugriff auf die PowerShell Universal Management API aufgerufen werden soll. Sie können Connect-PSUServer auch aufrufen, bevor Sie dieses Cmdlet verwenden, um den Computernamen für die gesamte Sitzung festzulegen. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Copyright Der Copyright-Text auf der Anmeldeseite und in der integrierten Fußzeile, wo er dargestellt wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Anmeldeinformationen für die Anmeldung an der PowerShell Universal Management-API. ```yaml Type: PSCredential Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -CssStylesheet Kompatibilitätsparameter mit Branding-Stylesheet-URLs. Die aktuelle Admin-Konsole lädt diese nicht als globale Stylesheets. Für CSS der Anmeldeseite verwenden Sie `-LoginPageCssStylesheet`. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -CssStylesheetIntegrity Zugehörige Integritätswerte für `-CssStylesheet`. Dadurch wird `-LoginPageCssStylesheet` kein Integritätsattribut hinzugefügt. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Favicon Die URL oder der Text für das Symbol der System-Browserregisterkarte. Branding ist die konfigurierbare Quelle für das System-Favicon; wenn nichts festgelegt ist, wird der Standard verwendet. HTTP- und HTTPS-URLs können ohne Erweiterung sein. Relative Bildorte müssen einen Pfad verwenden (zum Beispiel `/branding/icon`, `./images/icon` oder `images/icon`) oder einen Dateinamen mit einer Bilderweiterung (zum Beispiel `favicon.ico`). Andere Werte werden als SVG-Text dargestellt. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -HeaderColor Kompatibilitätseinstellung für ältere Kopfzeilenlayouts. Das aktuelle Konsolenlayout wendet sie nicht an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -HeaderFontColor Kompatibilitätseinstellung für ältere Kopfzeilenlayouts. Das aktuelle Konsolenlayout wendet sie nicht an. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Fordert Zugriff auf die integrierte Management-API an, wenn das API-Sicherheitsmodell des Servers dies zulässt. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoggedOut Der Titel auf dem integrierten Abmeldebildschirm. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoggedOutDescription Die Beschreibung auf dem integrierten Abmeldebildschirm. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageDescription Die Beschreibung, die in der Nähe des Anmeldelogos angezeigt wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageImage Die URL des Bilds, das auf der Anmeldeseite verwendet werden soll. Veröffentlichen Sie das Asset, damit nicht authentifizierte Browser es laden können; dieser Parameter liest keine lokale Serverdatei. ```yaml Type: String Parameter Sets: (All) Aliases: Image Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLinks Kompatibilitätsparameter, der Anmeldeseitenlinks akzeptiert. Die aktuellen vertikalen und horizontalen Anmeldevorlagen rendern diese Links nicht. ```yaml Type: LoginPageLink[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageText Die Überschrift in der Anmeldekarte. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageTitle Der Titel der Anmeldeseite und das Browser-Titelsuffix. Im aktuellen Anmeldelayout wird der sichtbare benutzerdefinierte Titel unter dem Logo dargestellt, wenn ein benutzerdefiniertes `-LoginPageImage` angegeben ist. ```yaml Type: String Parameter Sets: (All) Aliases: Title Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -NotAuthorizedDescription Die Beschreibung, die angezeigt wird, wenn der Benutzer nicht autorisiert ist. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -NotAuthorizedTitle Der Titel, der angezeigt wird, wenn der Benutzer nicht autorisiert ist. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PageNotFoundDescription Die Beschreibung, die angezeigt wird, wenn die Seite nicht gefunden wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PageNotFoundTitle Der Titel, der angezeigt wird, wenn die Seite nicht gefunden wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PrimaryColor Hintergrundfarbe integrierter Karten, die die primäre Branding-Farbe verwenden, etwa die Karte zum Zurücksetzen des Kennworts. Dies ist keine Material UI-Paletteneinstellung für Apps. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PrimaryFontColor Vordergrundfarbe, die auf integrierten Karten mit `-PrimaryColor` gepaart ist. Legen Sie beide Werte zusammen fest. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SecondaryColor Hintergrundfarbe der integrierten Admin- und Portalnavigation bzw. Seitenleiste. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SecondaryFontColor Geerbte Vordergrundfarbe der integrierten Navigation. Spezifischere Komponentenstile können sie überschreiben. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Gibt an, ob das Cmdlet Zertifikatprobleme ignorieren soll. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Gibt an, ob das Cmdlet die Standardanmeldeinformationen verwenden soll. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DarkAppBarLogo Die URL des alternativen Navigationslogos, das verwendet wird, wenn das dunkle Design aktiv ist. Legen Sie auch `-AppBarLogo` fest. Dies ändert nicht das Anmeldebild. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageTheme Die Designpräferenz für die Anmeldeseite: `System`, `Light` oder `Dark`. Der Standard ist `System`, nicht `Auto`. Der Systemmodus berücksichtigt die gespeicherte PSU-Designpräferenz des Browsers und andernfalls die Farbpräferenz des Betriebssystems. Dies legt nicht das Design der angemeldeten Konsole fest. ```yaml Type: ThemePreference Parameter Sets: (All) Aliases: Required: False Position: Named Default value: System Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalTitle Der Titel, der von den Ressourcensuche- und Skriptseiten des Portals verwendet wird. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageCssStylesheet Eine Stylesheet-URL, die auf den Anmelde- und Anmeldefehlerseiten geladen wird. Sie gestaltet die Konsole oder Apps nicht global. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLayout Das Layout der Anmeldeseite: `Vertical` (Standard) oder `Horizontal`. Das horizontale Layout kann auf schmalen Bildschirmen gestapelt werden. ```yaml Type: LoginPageLayout Parameter Sets: (All) Aliases: Required: False Position: Named Default value: Vertical Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageBackgroundColor Die Hintergrundfarbe des Anmeldelayouts sowie die Hintergrund- und Rahmenfarbe der primären Anmeldeschaltfläche. Dies entfernt kein integriertes Hintergrundbild und legt nicht die Textfarbe der Schaltfläche fest. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageFontColor Die Farbe der Typografie der Anmeldeseite, keine separate Einstellung für Eingabetext- oder Schaltflächenbeschriftungsfarbe. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLogoSize Die benutzerdefinierte Breite des Anmeldelogos. Pixel, Prozentwerte und andere gültige CSS-Breiten sind zulässig, zum Beispiel `180px`. Wenn nichts festgelegt ist, verwendet ein benutzerdefiniertes Anmeldebild eine Breite von `128px`. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Verwendet Authentifizierungs-Cookies der aktuellen PowerShell-Sitzung erneut und behält sie bei. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## EINGABEN ### Keine ## AUSGABEN ### System.Object ## HINWEISE ## VERWANDTE LINKS * [Branding-Beispiele](/powershell-universal/de/config/login-page.md) * [New-PSUBranding](/powershell-universal/de/powershell-befehle/new-psubranding.md) ## BERECHTIGUNGEN Das Zugriffstoken erfordert `settings.branding/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-psubranding.md?ask=&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.