> 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 ### Synopsis Sets branding for PowerShell Universal. ### Syntax ```powershell New-PSUBranding [-AdminConsoleTitle ] [-AppBarLogo ] [-AppNotRunningDescription ] [-AppToken ] [-ComputerName ] [-Copyright ] [-Credential ] [-CssStylesheet ] [-CssStylesheetIntegrity ] [-Favicon ] [-HeaderColor ] [-HeaderFontColor ] [-Integrated] [-LoggedOut ] [-LoggedOutDescription ] [-LoginPageDescription ] [-LoginPageImage ] [-LoginPageLinks ] [-LoginPageText ] [-LoginPageTitle ] [-NotAuthorizedDescription ] [-NotAuthorizedTitle ] [-PageNotFoundDescription ] [-PageNotFoundTitle ] [-PrimaryColor ] [-PrimaryFontColor ] [-SecondaryColor ] [-SecondaryFontColor ] [-TrustCertificate] [-UseDefaultCredentials] [-DarkAppBarLogo ] [-LoginPageTheme ] [-PortalTitle ] [-LoginPageCssStylesheet ] [-LoginPageLayout ] [-LoginPageBackgroundColor ] [-LoginPageFontColor ] [-LoginPageLogoSize ] [] ``` ### Description {{ Fill in the Description }} ### Parameters #### -AdminConsoleTitle The title of the admin console. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -AppBarLogo The URL of the logo to use in the app bar. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -AppNotRunningDescription The text to display when the app is not running. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -AppToken The AppToken that is used for calling the PowerShell Universal Management API. You can also call Connect-PSUServer before calling this cmdlet to set the AppToken for the entire session. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -ComputerName Specifies the computer name or URL that should be called when accessing the PowerShell Universal Management API. You can also use Connect-PSUServer before calling this cmdlet to set the computer name for the entire session. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases Uri Accept wildcard characters? false ``` #### -Copyright The copyright text to display in the footer. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Credential Credentials to login to the PowerShell Universal Management API. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -CssStylesheet \ The URL of the CSS stylesheet to use for branding. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -CssStylesheetIntegrity \ The integrity attribute for the CSS stylesheet. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -Favicon The URL of the favicon to use for branding. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -HeaderColor The header background color. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -HeaderFontColor The header font color. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false -Integrated [] Whether the cmdlet should use the integrated PowerShell Universal Management API. Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoggedOut The text to display when the user is logged out. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoggedOutDescription The text to display when the user is logged out. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageDescription The description to display on the login page. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageImage The URL of the image to use on the login page. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases Image Accept wildcard characters? false ``` #### -LoginPageLinks \ The links to display on the login page. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageText The text to display on the login page. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageTitle The title to display on the login page. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases Title Accept wildcard characters? false ``` #### -NotAuthorizedDescription The description to display when the user is not authorized. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -NotAuthorizedTitle The title to display when the user is not authorized. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -PageNotFoundDescription The description to display when the page is not found. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -PageNotFoundTitle The title to display when the page is not found. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -PrimaryColor The primary color to use for branding. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -PrimaryFontColor The primary font color to use for branding. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -SecondaryColor The secondary color to use for branding. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -SecondaryFontColor The secondary font color to use for branding. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false -TrustCertificate [] Whether the cmdlet should ignore certificate issues. Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false -UseDefaultCredentials [] Whether the cmdlet should use the default credentials. Required? false Position? named Default value False Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -DarkAppBarLogo The URL of the dark logo to use in the app bar. This will be used when the dark theme is enabled. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageTheme The theme preference for the login page. This can be set to Light, Dark, or Auto. The default is Auto. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -PortalTitle The title of the portal. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageCssStylesheet A style sheet for the login page. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageLayout The login page layout. Defaults to vertical. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageBackgroundColor The background color of the login page. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageFontColor The font color of the login page. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false ``` #### -LoginPageLogoSize The size of of the login page logo. Pixels, percentages and any valid CSS width is allowed. ``` Required? false Position? named Default value None Accept pipeline input? False Aliases none Accept wildcard characters? false This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216). ``` ### Inputs None ### Outputs System.Object ### Notes \-------------------------- Example 1 -------------------------- ``` PS C:\> New-PSUBranding -LoginPageImage 'C:\logo.png' -AppBarLogo 'C:\logo.png' -AdminConsoleTitle 'My Admin Console' Sets the branding for PowerShell Universal. The login page image and app bar logo are set to the specified image files. The admin console title is set to "My Admin Console". ``` --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/powershell-commands/new-psubranding.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.