> 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-psubranding.md). # Set-PSUBranding Set-PSUBranding personalizza il branding, i colori e i loghi del portale, della pagina di accesso e della console di amministrazione per una distribuzione di PowerShell Universal. ## SINOSSI Imposta il branding per PowerShell Universal. ## SINTASSI ``` 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] [] ``` ## DESCRIZIONE Aggiorna le impostazioni di branding del portale, della pagina di accesso e della console di amministrazione per PowerShell Universal. `New-PSUBranding` e `New-PSULoginPage` sono alias di questo cmdlet. Ogni chiamata sostituisce la definizione di branding invece di unire solo i parametri forniti. Includa tutte le impostazioni che desidera conservare. Quando viene valutato in `.universal\branding.ps1`, il cmdlet produce l'oggetto di configurazione che PSU carica. Al di fuori del caricamento della configurazione, applica la definizione al server connesso e la restituisce. Vedere [Branding](/powershell-universal/it/config/login-page.md) per esempi completi, l'hosting di asset pubblici, i layout di accesso, i colori, i CSS, i messaggi di errore e le note di compatibilità. ## ESEMPI ### Esempio 1: impostare i loghi e il titolo della console ```powershell Set-PSUBranding -LoginPageImage '/branding/logo.png' -AppBarLogo '/branding/logo.png' -AdminConsoleTitle 'My Admin Console' ``` Imposta l'immagine di accesso, il logo di navigazione e il suffisso del titolo del browser della console di amministrazione. Pubblichi prima l'immagine all'URL specificato. I parametri dell'immagine accettano URL accessibili al browser, non percorsi del file system del server. Gli asset necessari prima dell'accesso devono consentire l'accesso anonimo. Questa chiamata sostituisce qualsiasi definizione di branding esistente. ### Esempio 2: mantenere un profilo di branding completo ```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 ``` Mantiene insieme le impostazioni correlate in modo che l'applicazione del profilo non ometta i valori precedenti. Usi `System`, `Light` o `Dark` per il tema e `Vertical` o `Horizontal` per il layout. ## PARAMETRI ### -AdminConsoleTitle Il suffisso del titolo del browser della console di amministrazione. Una licenza per sviluppatori usa invece il titolo di sviluppo. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppBarLogo L'URL del logo normale da usare nella navigazione integrata della console e del portale. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppNotRunningDescription Il testo da visualizzare nella schermata di app non in esecuzione del framework delle app, non nella schermata di avvio o di caricamento del server. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppToken L'AppToken usato per chiamare la Management API di PowerShell Universal. Può anche chiamare Connect-PSUServer prima di chiamare questo cmdlet per impostare l'AppToken per l'intera sessione. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Specifica il nome del computer o l'URL da chiamare quando si accede alla Management API di PowerShell Universal. Può anche usare Connect-PSUServer prima di chiamare questo cmdlet per impostare il nome del computer per l'intera sessione. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Copyright Il testo del copyright nella pagina di accesso e nel piè di pagina integrato, dove viene visualizzato. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Credenziali per accedere all'API di gestione di PowerShell Universal. ```yaml Type: PSCredential Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -CssStylesheet Parametro di compatibilità che contiene URL di fogli di stile di branding. La console di amministrazione corrente non li carica come fogli di stile globali. Per il CSS della pagina di accesso, usi `-LoginPageCssStylesheet`. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -CssStylesheetIntegrity Valori di integrità complementari per `-CssStylesheet`. Questo non aggiunge un attributo di integrità a `-LoginPageCssStylesheet`. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Favicon L'URL o il testo da usare per l'icona della scheda del browser di sistema. Il branding è l'origine configurabile della favicon di sistema; se non è impostato, viene usato il valore predefinito. Gli URL HTTP e HTTPS possono essere privi di estensione. I percorsi relativi delle immagini devono usare un percorso (ad esempio `/branding/icon`, `./images/icon` o `images/icon`) oppure un nome di file con un'estensione di immagine (ad esempio `favicon.ico`). Gli altri valori vengono visualizzati come testo SVG. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -HeaderColor Impostazione di compatibilità per i layout di intestazione precedenti. Il layout corrente della console non la applica. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -HeaderFontColor Impostazione di compatibilità per i layout di intestazione precedenti. Il layout corrente della console non la applica. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Richiede l'accesso alla Management API integrata quando il modello di sicurezza dell'API del server lo consente. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoggedOut Il titolo nella schermata di disconnessione integrata. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoggedOutDescription La descrizione nella schermata di disconnessione integrata. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageDescription La descrizione da visualizzare accanto al logo di accesso. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageImage L'URL dell'immagine da usare nella pagina di accesso. Pubblichi l'asset in modo che i browser non autenticati possano caricarlo; questo parametro non legge un file locale del server. ```yaml Type: String Parameter Sets: (All) Aliases: Image Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLinks Parametro di compatibilità che accetta link della pagina di accesso. I modelli di accesso verticali e orizzontali correnti non visualizzano questi link. ```yaml Type: LoginPageLink[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageText L'intestazione all'interno della scheda di accesso. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageTitle Il titolo della pagina di accesso e il suffisso del titolo del browser. Nel layout di accesso corrente, il titolo personalizzato visibile sotto il logo viene rappresentato quando viene fornito un `-LoginPageImage` personalizzato. ```yaml Type: String Parameter Sets: (All) Aliases: Title Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -NotAuthorizedDescription La descrizione da visualizzare quando l'utente non è autorizzato. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -NotAuthorizedTitle Il titolo da visualizzare quando l'utente non è autorizzato. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PageNotFoundDescription La descrizione da visualizzare quando la pagina non viene trovata. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PageNotFoundTitle Il titolo da visualizzare quando la pagina non viene trovata. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PrimaryColor Colore di sfondo delle schede integrate che usano il colore di branding principale, come la scheda di reimpostazione della password. Non è un'impostazione della tavolozza Material UI dell'app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PrimaryFontColor Colore di primo piano abbinato a `-PrimaryColor` sulle schede integrate. Imposti entrambi i valori insieme. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SecondaryColor Colore di sfondo della navigazione e della barra laterale integrate di amministrazione e del portale. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SecondaryFontColor Colore di primo piano ereditato della navigazione integrata. Stili di componente più specifici possono sostituirlo. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Indica se il cmdlet deve ignorare i problemi del certificato. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Indica se il cmdlet deve usare le credenziali predefinite. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DarkAppBarLogo L'URL del logo di navigazione alternativo usato quando il tema scuro è attivo. Imposti anche `-AppBarLogo`. Questo non cambia l'immagine di accesso. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageTheme La preferenza di tema della pagina di accesso: `System`, `Light` o `Dark`. Il valore predefinito è `System`, non `Auto`. La modalità System considera la preferenza di tema PSU salvata del browser e, in caso contrario, la preferenza di colore del sistema operativo. Questo non imposta il tema della console con la sessione avviata. ```yaml Type: ThemePreference Parameter Sets: (All) Aliases: Required: False Position: Named Default value: System Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalTitle Il titolo usato dalle pagine di ricerca delle risorse e degli script del portale. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageCssStylesheet Un URL di foglio di stile caricato nelle pagine di accesso e di errore di accesso. Non applica uno stile globale alla console o alle app. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLayout Il layout della pagina di accesso: `Vertical` (predefinito) o `Horizontal`. Il layout orizzontale può impilarsi sugli schermi stretti. ```yaml Type: LoginPageLayout Parameter Sets: (All) Aliases: Required: False Position: Named Default value: Vertical Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageBackgroundColor Il colore di sfondo del layout di accesso e il colore di sfondo e del bordo del pulsante di accesso principale. Questo non rimuove un'immagine di sfondo integrata né imposta il colore del testo del pulsante. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageFontColor Il colore della tipografia della pagina di accesso, non un'impostazione distinta del colore del testo di input o dell'etichetta del pulsante. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLogoSize La larghezza personalizzata del logo di accesso. Sono consentiti pixel, percentuali e altre larghezze CSS valide; ad esempio, `180px`. Se non è impostata, un'immagine di accesso personalizzata usa una larghezza di `128px`. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Riutilizza e mantiene i cookie di autenticazione per la sessione di PowerShell corrente. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable e -ProgressAction. Per maggiori informazioni, veda [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUT ### Nessuno ## OUTPUT ### System.Object ## NOTE ## LINK CORRELATI * [Esempi di branding](/powershell-universal/it/config/login-page.md) * [New-PSUBranding](/powershell-universal/it/comandi-powershell/new-psubranding.md) ## 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/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.