> 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/es/comandos-de-powershell/set-psubranding.md). # Set-PSUBranding Set-PSUBranding personaliza el branding, los colores y los logotipos del portal, de la página de inicio de sesión y de la consola de administración para una implementación de PowerShell Universal. ## SINOPSIS Establece el branding de PowerShell Universal. ## SINTAXIS ``` 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] [] ``` ## DESCRIPCIÓN Actualiza la configuración de branding del portal, de la página de inicio de sesión y de la consola de administración para PowerShell Universal. `New-PSUBranding` y `New-PSULoginPage` son alias de este cmdlet. Cada llamada reemplaza la definición de branding en lugar de combinar solo los parámetros indicados. Incluya toda la configuración que desee conservar. Cuando se evalúa en `.universal\branding.ps1`, el cmdlet produce el objeto de configuración que carga PSU. Fuera de la carga de la configuración, aplica la definición al servidor conectado y la devuelve. Consulte [Branding](/powershell-universal/es/config/login-page.md) para ver ejemplos completos, el hospedaje de activos públicos, los diseños de inicio de sesión, los colores, CSS, los mensajes de error y las notas de compatibilidad. ## EJEMPLOS ### Ejemplo 1: establecer los logotipos y el título de la consola ```powershell Set-PSUBranding -LoginPageImage '/branding/logo.png' -AppBarLogo '/branding/logo.png' -AdminConsoleTitle 'My Admin Console' ``` Establece la imagen de inicio de sesión, el logotipo de navegación y el sufijo del título del navegador de la consola de administración. Publique primero la imagen en la URL especificada. Los parámetros de imagen aceptan URL accesibles para el navegador, no rutas del sistema de ficheros del servidor. Los activos necesarios antes del inicio de sesión deben permitir el acceso anónimo. Esta llamada reemplaza cualquier definición de branding existente. ### Ejemplo 2: conservar un perfil de 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 junta la configuración relacionada para que al aplicar el perfil no se omitan los valores anteriores. Use `System`, `Light` o `Dark` para el tema y `Vertical` u `Horizontal` para el diseño. ## PARÁMETROS ### -AdminConsoleTitle El sufijo del título del navegador de la consola de administración. Una licencia de desarrollador usa en su lugar el título de desarrollo. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppBarLogo La URL del logotipo normal que se usará en la navegación integrada de la consola y del portal. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppNotRunningDescription El texto que se mostrará en la pantalla de aplicación no en ejecución del marco de aplicaciones, no en la pantalla de inicio o de carga del servidor. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppToken El AppToken que se usa para llamar a la Management API de PowerShell Universal. También puede llamar a Connect-PSUServer antes de llamar a este cmdlet para establecer el AppToken para toda la sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Especifica el nombre del equipo o la URL que se debe llamar al acceder a la Management API de PowerShell Universal. También puede usar Connect-PSUServer antes de llamar a este cmdlet para establecer el nombre del equipo para toda la sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Copyright El texto de copyright en la página de inicio de sesión y en el pie de página integrado, donde se muestra. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Credenciales para iniciar sesión en la API de administración de 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 Parámetro de compatibilidad que contiene URL de hojas de estilos de branding. La consola de administración actual no las carga como hojas de estilos globales. Para el CSS de la página de inicio de sesión, use `-LoginPageCssStylesheet`. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -CssStylesheetIntegrity Valores de integridad complementarios para `-CssStylesheet`. Esto no añade un atributo de integridad 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 La URL o el texto que se usará para el icono de la pestaña del navegador del sistema. El branding es el origen configurable del favicon del sistema; si no se establece, se usa el valor predeterminado. Las URL HTTP y HTTPS pueden carecer de extensión. Las ubicaciones de imagen relativas deben usar una ruta (por ejemplo, `/branding/icon`, `./images/icon` o `images/icon`) o un nombre de fichero con una extensión de imagen (por ejemplo, `favicon.ico`). Los demás valores se representan como texto SVG. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -HeaderColor Configuración de compatibilidad para diseños de encabezado antiguos. El diseño actual de la consola no la aplica. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -HeaderFontColor Configuración de compatibilidad para diseños de encabezado antiguos. El diseño actual de la consola no la aplica. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Solicita acceso a la Management API integrada cuando el modelo de seguridad de la API del servidor lo permite. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoggedOut El título en la pantalla de cierre de sesión integrada. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoggedOutDescription La descripción en la pantalla de cierre de sesión integrada. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageDescription La descripción que se mostrará junto al logotipo de inicio de sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageImage La URL de la imagen que se usará en la página de inicio de sesión. Publique el activo para que los navegadores no autenticados puedan cargarlo; este parámetro no lee un fichero local del servidor. ```yaml Type: String Parameter Sets: (All) Aliases: Image Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLinks Parámetro de compatibilidad que acepta enlaces de la página de inicio de sesión. Las plantillas de inicio de sesión verticales y horizontales actuales no representan estos enlaces. ```yaml Type: LoginPageLink[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageText El encabezado dentro de la tarjeta de inicio de sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageTitle El título de la página de inicio de sesión y el sufijo del título del navegador. En el diseño de inicio de sesión actual, el título personalizado visible bajo el logotipo se representa cuando se proporciona un `-LoginPageImage` personalizado. ```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 descripción que se mostrará cuando el usuario no esté autorizado. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -NotAuthorizedTitle El título que se mostrará cuando el usuario no esté autorizado. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PageNotFoundDescription La descripción que se mostrará cuando no se encuentre la página. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PageNotFoundTitle El título que se mostrará cuando no se encuentre la página. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PrimaryColor Color de fondo de las tarjetas integradas que usan el color de branding principal, como la tarjeta de restablecimiento de contraseña. No es una configuración de paleta de Material UI de la aplicación. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PrimaryFontColor Color de primer plano emparejado con `-PrimaryColor` en las tarjetas integradas. Establezca ambos valores juntos. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SecondaryColor Color de fondo de la navegación y de la barra lateral integradas de administración y del portal. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -SecondaryFontColor Color de primer plano heredado de la navegación integrada. Estilos de componente más específicos pueden reemplazarlo. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Indica si el cmdlet debe ignorar los problemas de certificado. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Indica si el cmdlet debe usar las credenciales predeterminadas. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DarkAppBarLogo La URL del logotipo de navegación alternativo que se usa cuando el tema oscuro está activo. Establezca también `-AppBarLogo`. Esto no cambia la imagen de inicio de sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageTheme La preferencia de tema de la página de inicio de sesión: `System`, `Light` o `Dark`. El valor predeterminado es `System`, no `Auto`. El modo System tiene en cuenta la preferencia de tema de PSU guardada del navegador y, en caso contrario, la preferencia de color del sistema operativo. Esto no establece el tema de la consola con la sesión iniciada. ```yaml Type: ThemePreference Parameter Sets: (All) Aliases: Required: False Position: Named Default value: System Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalTitle El título usado por las páginas de búsqueda de recursos y de scripts del portal. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageCssStylesheet Una URL de hoja de estilos cargada en las páginas de inicio de sesión y de error de inicio de sesión. No aplica estilos de forma global a la consola ni a las aplicaciones. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLayout El diseño de la página de inicio de sesión: `Vertical` (predeterminado) o `Horizontal`. El diseño horizontal puede apilarse en pantallas estrechas. ```yaml Type: LoginPageLayout Parameter Sets: (All) Aliases: Required: False Position: Named Default value: Vertical Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageBackgroundColor El color de fondo del diseño de inicio de sesión y el color de fondo y de borde del botón principal de inicio de sesión. Esto no quita una imagen de fondo integrada ni establece el color del texto del botón. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageFontColor El color de la tipografía de la página de inicio de sesión, no una configuración distinta del color del texto de entrada o de la etiqueta del botón. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoginPageLogoSize El ancho personalizado del logotipo de inicio de sesión. Se permiten píxeles, porcentajes y otros anchos CSS válidos; por ejemplo, `180px`. Si no se establece, una imagen de inicio de sesión personalizada usa un ancho de `128px`. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Reutiliza y conserva las cookies de autenticación de la sesión actual de PowerShell. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para obtener más información, consulte [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRADAS ### Ninguno ## SALIDAS ### System.Object ## NOTAS ## ENLACES RELACIONADOS * [Ejemplos de branding](/powershell-universal/es/config/login-page.md) * [New-PSUBranding](/powershell-universal/es/comandos-de-powershell/new-psubranding.md) ## PERMISOS El token de acceso requiere `settings.branding/update` para ejecutar este cmdlet de forma remota. --- # 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/es/comandos-de-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.