> 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/powershell-commands/new-psubranding.md).

# New-PSUBranding

New-PSUBranding configures branding options for PowerShell Universal, such as logos, colors, login page text, and admin console title.

## SYNOPSIS

Sets PowerShell Universal branding.

## SYNTAX

```powershell
New-PSUBranding [-LoginPageImage <String>] [-AppBarLogo <String>] [-AdminConsoleTitle <String>] [-LoginPageTitle <String>] [-LoginPageText <String>] [-LoginPageDescription <String>] [-PrimaryColor <String>] [-SecondaryColor <String>] [-PrimaryFontColor <String>] [-SecondaryFontColor <String>] [-HeaderFontColor <String>] [-HeaderColor <String>] [-Copyright <String>] [-LoginPageLinks <LoginPageLink[]>] [-CssStylesheet <String[]>] [-CssStylesheetIntegrity <String[]>] [-PageNotFoundDescription <String>] [-NotAuthorizedDescription <String>] [-AppNotRunningDescription <String>] [-PageNotFoundTitle <String>] [-NotAuthorizedTitle <String>] [-LoggedOut <String>] [-LoggedOutDescription <String>] [-Favicon <String>] [-DarkAppBarLogo <String>] [-PortalTitle <String>] [-LoginPageTheme <ThemePreference>] [-LoginPageCssStylesheet <String>] [-LoginPageLayout <LoginPageLayout>] [-LoginPageBackgroundColor <String>] [-LoginPageLogoSize <String>] [-LoginPageFontColor <String>] [<ConnectionOptions>] [<CommonParameters>]
```

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

## DESCRIPTION

This legacy name is an alias of `Set-PSUBranding` (also aliased as `New-PSULoginPage`). It sets the server's branding for the admin console, app bar, login page, portal, and error pages. Specify the desired branding values and use an app token with branding-update permission for remote calls.

A call replaces the branding definition rather than merging only the supplied parameters. Include the settings you want to preserve. See [Branding](/powershell-universal/config/login-page.md) for complete profiles, public asset hosting, CSS examples, and compatibility notes.

## EXAMPLES

```powershell
New-PSUBranding -LoginPageImage '/branding/logo.png' -AppBarLogo '/branding/logo.png' -AdminConsoleTitle 'My Admin Console'
```

Sets the login image, app bar logo, and admin console title. Publish the image first at the specified URL; these parameters do not read server filesystem paths. Assets used before login must allow anonymous access. This example replaces any existing branding definition.

## PARAMETERS

| Parameter                   | Description                                                                                  |
| --------------------------- | -------------------------------------------------------------------------------------------- |
| `-LoginPageImage`           | URL of the image used on the login page (alias `-Image`).                                    |
| `-AppBarLogo`               | URL of the regular navigation logo.                                                          |
| `-DarkAppBarLogo`           | URL of the navigation logo for dark theme; also set `-AppBarLogo`.                           |
| `-AdminConsoleTitle`        | Admin console browser-title suffix.                                                          |
| `-LoginPageTitle`           | Login page title (alias `-Title`).                                                           |
| `-LoginPageText`            | Heading inside the sign-in card.                                                             |
| `-LoginPageDescription`     | Description near the login logo.                                                             |
| `-PrimaryColor`             | Background color for built-in cards that consume the primary branding color.                 |
| `-SecondaryColor`           | Navigation/sidebar background color.                                                         |
| `-PrimaryFontColor`         | Foreground paired with `-PrimaryColor` on built-in cards.                                    |
| `-SecondaryFontColor`       | Navigation's inherited foreground color.                                                     |
| `-HeaderFontColor`          | Compatibility setting for older header layouts.                                              |
| `-HeaderColor`              | Compatibility setting for older header layouts.                                              |
| `-Copyright`                | Copyright text on the login page and built-in footer where rendered.                         |
| `-LoginPageLinks`           | Compatibility parameter; the current login templates do not render these links.              |
| `-CssStylesheet`            | Compatibility stylesheet URL array; not loaded globally by the current console.              |
| `-CssStylesheetIntegrity`   | Companion integrity values for `-CssStylesheet`, not `-LoginPageCssStylesheet`.              |
| `-PageNotFoundDescription`  | Description for a missing page.                                                              |
| `-PageNotFoundTitle`        | Title for a missing page.                                                                    |
| `-NotAuthorizedDescription` | Description for an unauthorized page.                                                        |
| `-NotAuthorizedTitle`       | Title for an unauthorized page.                                                              |
| `-AppNotRunningDescription` | Description shown for an app that is not running.                                            |
| `-LoggedOut`                | Title shown on the built-in logout screen.                                                   |
| `-LoggedOutDescription`     | Description shown on the built-in logout screen.                                             |
| `-Favicon`                  | Browser-tab icon URL; the current implementation also supports text rendered as an SVG icon. |
| `-PortalTitle`              | Title for the portal's resource search and script pages.                                     |
| `-LoginPageTheme`           | Login theme: `System` (default), `Light`, or `Dark`; not `Auto`.                             |
| `-LoginPageCssStylesheet`   | Stylesheet URL loaded on login and login-error pages.                                        |
| `-LoginPageLayout`          | `Vertical` (default) or `Horizontal`.                                                        |
| `-LoginPageBackgroundColor` | Login layout background and primary sign-in button background/border color.                  |
| `-LoginPageLogoSize`        | Custom login logo width, for example `180px`; defaults to `128px`.                           |
| `-LoginPageFontColor`       | Login typography color, not a button-label color.                                            |
| `-ComputerName`             | Target PSU server URL or host name (alias `-Uri`).                                           |
| `-AppToken`                 | Management API app token.                                                                    |
| `-Credential`               | Management API credentials.                                                                  |
| `-UseDefaultCredentials`    | Uses current Windows credentials.                                                            |
| `-Integrated`               | Requests integrated management API access when permitted by the server's API security model. |
| `-TrustCertificate`         | Ignores certificate validation errors.                                                       |
| `-Cookies`                  | Reuses session authentication cookies.                                                       |

## PERMISSIONS

The access token requires `settings.branding/update` to run this cmdlet remotely.


---

# 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/powershell-commands/new-psubranding.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.