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

# New-PSUBranding

New-PSUBranding configura le opzioni di branding per PowerShell Universal, come loghi, colori, testo della pagina di accesso e titolo della console di amministrazione.

## SINOSSI

Imposta il branding di PowerShell Universal.

## SINTASSI

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

## DESCRIZIONE

Questo nome legacy è un alias di `Set-PSUBranding` (con alias anche `New-PSULoginPage`). Imposta il branding del server per la console di amministrazione, la barra dell'app, la pagina di accesso, il portale e le pagine di errore. Specifichi i valori di branding desiderati e usi un token dell'app con l'autorizzazione di aggiornamento del branding per le chiamate remote.

Una chiamata sostituisce la definizione di branding invece di unire solo i parametri forniti. Includa le impostazioni che desidera conservare. Vedere [Branding](/powershell-universal/it/config/login-page.md) per profili completi, l'hosting di asset pubblici, esempi CSS e note di compatibilità.

## ESEMPI

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

Imposta l'immagine di accesso, il logo della barra dell'app e il titolo della console di amministrazione. Pubblichi prima l'immagine all'URL specificato; questi parametri non leggono percorsi del file system del server. Gli asset usati prima dell'accesso devono consentire l'accesso anonimo. Questo esempio sostituisce qualsiasi definizione di branding esistente.

## PARAMETRI

| Parametro                   | Descrizione                                                                                                           |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `-LoginPageImage`           | URL dell'immagine usata nella pagina di accesso (alias `-Image`).                                                     |
| `-AppBarLogo`               | URL del logo di navigazione normale.                                                                                  |
| `-DarkAppBarLogo`           | URL del logo di navigazione per il tema scuro; imposti anche `-AppBarLogo`.                                           |
| `-AdminConsoleTitle`        | Suffisso del titolo del browser della console di amministrazione.                                                     |
| `-LoginPageTitle`           | Titolo della pagina di accesso (alias `-Title`).                                                                      |
| `-LoginPageText`            | Intestazione all'interno della scheda di accesso.                                                                     |
| `-LoginPageDescription`     | Descrizione accanto al logo di accesso.                                                                               |
| `-PrimaryColor`             | Colore di sfondo delle schede integrate che usano il colore di branding principale.                                   |
| `-SecondaryColor`           | Colore di sfondo della navigazione e della barra laterale.                                                            |
| `-PrimaryFontColor`         | Primo piano abbinato a `-PrimaryColor` sulle schede integrate.                                                        |
| `-SecondaryFontColor`       | Colore di primo piano ereditato della navigazione.                                                                    |
| `-HeaderFontColor`          | Impostazione di compatibilità per i layout di intestazione precedenti.                                                |
| `-HeaderColor`              | Impostazione di compatibilità per i layout di intestazione precedenti.                                                |
| `-Copyright`                | Testo di copyright nella pagina di accesso e nel piè di pagina integrato, quando viene visualizzato.                  |
| `-LoginPageLinks`           | Parametro di compatibilità; i modelli di accesso correnti non visualizzano questi link.                               |
| `-CssStylesheet`            | Matrice di URL di fogli di stile di compatibilità; non caricata globalmente dalla console corrente.                   |
| `-CssStylesheetIntegrity`   | Valori di integrità complementari per `-CssStylesheet`, non per `-LoginPageCssStylesheet`.                            |
| `-PageNotFoundDescription`  | Descrizione di una pagina mancante.                                                                                   |
| `-PageNotFoundTitle`        | Titolo di una pagina mancante.                                                                                        |
| `-NotAuthorizedDescription` | Descrizione di una pagina non autorizzata.                                                                            |
| `-NotAuthorizedTitle`       | Titolo di una pagina non autorizzata.                                                                                 |
| `-AppNotRunningDescription` | Descrizione visualizzata per un'app che non è in esecuzione.                                                          |
| `-LoggedOut`                | Titolo mostrato nella schermata di disconnessione integrata.                                                          |
| `-LoggedOutDescription`     | Descrizione mostrata nella schermata di disconnessione integrata.                                                     |
| `-Favicon`                  | URL dell'icona della scheda del browser; l'implementazione corrente supporta anche testo visualizzato come icona SVG. |
| `-PortalTitle`              | Titolo delle pagine di ricerca delle risorse e degli script del portale.                                              |
| `-LoginPageTheme`           | Tema di accesso: `System` (predefinito), `Light` o `Dark`; non `Auto`.                                                |
| `-LoginPageCssStylesheet`   | URL del foglio di stile caricato nelle pagine di accesso e di errore di accesso.                                      |
| `-LoginPageLayout`          | `Vertical` (predefinito) o `Horizontal`.                                                                              |
| `-LoginPageBackgroundColor` | Sfondo del layout di accesso e colore di sfondo e di bordo del pulsante di accesso principale.                        |
| `-LoginPageLogoSize`        | Larghezza del logo di accesso personalizzato, ad esempio `180px`; il valore predefinito è `128px`.                    |
| `-LoginPageFontColor`       | Colore della tipografia di accesso, non un colore dell'etichetta del pulsante.                                        |
| `-ComputerName`             | URL o nome host del server PSU di destinazione (alias `-Uri`).                                                        |
| `-AppToken`                 | Token dell'app dell'API di gestione.                                                                                  |
| `-Credential`               | Credenziali dell'API di gestione.                                                                                     |
| `-UseDefaultCredentials`    | Usa le credenziali Windows correnti.                                                                                  |
| `-Integrated`               | Richiede l'accesso alla Management API integrata quando il modello di sicurezza dell'API del server lo consente.      |
| `-TrustCertificate`         | Ignora gli errori di convalida del certificato.                                                                       |
| `-Cookies`                  | Riutilizza i cookie di autenticazione della sessione.                                                                 |

## AUTORIZZAZIONI

Il token di accesso richiede `settings.branding/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/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.
