> 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/fr/config/login-page.md). # Image de marque Personnalisez l'image de marque de PowerShell Universal avec des exemples pour les pages de connexion, les logos, les couleurs, les feuilles de style, les titres du portail et les messages d'erreur. {% hint style="info" %} La personnalisation de l'image de marque nécessite une [licence](https://store.devolutions.net/package#psu). {% endhint %} L'image de marque contrôle l'apparence et le texte de la page de connexion intégrée, de la console d'administration, du portail et de certaines pages d'erreur de PowerShell Universal. Utilisez **Paramètres > Image de marque** ou le fichier `.universal\branding.ps1` dans votre dépôt de configuration. Actualisez le navigateur après l'enregistrement; certaines images, certains styles et certains titres sont chargés à l'ouverture de la page. L'image de marque n'est pas un thème Material UI pour toute l'appli. Pour styliser les composants à l'intérieur d'une appli, utilisez les [thèmes d'appli](/powershell-universal/fr/applis/themes.md). ## Choisir comment configurer l'image de marque Dans **Paramètres > Image de marque**, utilisez les onglets **Texte**, **Couleurs**, **Images** et **Page de connexion**, puis sélectionnez **Enregistrer**. Les tableaux ci-dessous utilisent les noms de paramètres PowerShell afin que vous puissiez associer chaque exemple au paramètre correspondant. La mise à jour de l'image de marque exige la permission `settings.branding/update`. Pour la configuration en tant que code, conservez une seule définition d'image de marque dans `.universal\branding.ps1`. `New-PSUBranding` et `New-PSULoginPage` sont des alias de `Set-PSUBranding`. Dans un fichier de configuration, ils produisent l'objet d'image de marque que PSU charge. En dehors du chargement de la configuration, l'applet de commande applique l'objet au serveur connecté et le retourne. {% hint style="warning" %} Un appel d'applet de commande d'image de marque remplace la définition d'image de marque; il ne fusionne pas seulement les paramètres fournis. Les chaînes omises reviennent à leurs valeurs par défaut, et les valeurs de thème et de disposition omises deviennent `System` et `Vertical`. Conservez les paramètres voulus ensemble dans une seule définition. Les exemples ci-dessous étendent la même table de hachage `$branding` afin que les changements ultérieurs n'effacent pas les valeurs précédentes. {% endhint %} Si vous exécutez les exemples de façon interactive, connectez-vous d'abord au serveur voulu avec `Connect-PSUServer`. N'exécutez pas des exemples successifs sur un déploiement existant sans inclure les paramètres que vous voulez conserver. ## Héberger des images et des fichiers CSS Les paramètres d'image et de feuille de style acceptent des URL accessibles au navigateur, et non des chemins du système de fichiers du serveur. Par exemple, `C:\PSU\Branding\logo.png` est un fichier local, tandis que `/branding/logo.png` est l'URL que le navigateur peut demander. 1. Créez un dossier dédié, comme `C:\PSU\Branding`, sur le serveur PSU. Donnez au compte de service PSU un accès en lecture. 2. Placez vos fichiers d'image de marque publics dans ce dossier : `logo.png`, `logo-on-dark.png`, `favicon.ico` et, au besoin, `login.css`. 3. Publiez le dossier à `/branding`. Laissez l'authentification et les restrictions de rôle désactivées afin que la page de connexion puisse charger ces actifs avant qu'un utilisateur se connecte. Par exemple, placez cette définition dans `.universal\publishedFolders.ps1` : ```powershell New-PSUPublishedFolder -Name 'BrandingAssets' -Path 'C:\PSU\Branding' -RequestPath '/branding' ``` Ne placez dans ce dossier que des images et des feuilles de style publiques. Tout ce qu'il sert est accessible sans connexion; ne publiez pas votre dépôt de configuration, vos scripts, vos identifiants ni d'autres fichiers privés. Le chemin du système de fichiers peut se trouver à l'extérieur du dépôt de configuration. Sur les autres systèmes d'exploitation, utilisez un chemin local approprié. Ouvrez `/branding/logo.png` et `/branding/login.css` sur votre site PSU dans une fenêtre de navigation privée pour confirmer l'accès anonyme. Voir [Dossiers publiés](/powershell-universal/fr/plateforme/published-folders.md) pour plus de détails. Les exemples supposent que PSU est hébergé à la racine du site. S'il s'exécute sous un répertoire virtuel ou un préfixe de chemin de proxy, incluez ce préfixe dans les URL, ou utilisez des URL HTTPS complètes accessibles aux navigateurs de vos utilisateurs. N'utilisez pas une URL `localhost` à moins que chaque navigateur s'exécute sur le serveur lui-même. ## Exemple : une page de connexion et une console à l'image de marque Après avoir publié les actifs, placez ceci dans `.universal\branding.ps1` : ```powershell $branding = @{ AdminConsoleTitle = 'Contoso Automation' PortalTitle = 'Contoso Self-Service' LoginPageTitle = 'Contoso Automation' LoginPageText = 'Sign in with your work account' LoginPageDescription = 'Automation and self-service for Contoso employees.' LoginPageImage = '/branding/logo.png' LoginPageLogoSize = '180px' AppBarLogo = '/branding/logo.png' DarkAppBarLogo = '/branding/logo-on-dark.png' Favicon = '/branding/favicon.ico' Copyright = 'Copyright 2026 Contoso' LoginPageTheme = 'Light' LoginPageLayout = 'Vertical' } Set-PSUBranding @branding ``` La page de connexion affiche le logo personnalisé, la description et le titre de connexion. `LoginPageTitle` fournit aussi le suffixe du titre dans l'onglet du navigateur. Dans la disposition de connexion actuelle, le titre personnalisé visible sous le logo est affiché lorsqu'une `LoginPageImage` personnalisée est fournie. `AdminConsoleTitle` fournit le suffixe du titre de navigateur de la console d'administration; une licence de développeur utilise plutôt le titre de développement. `AppBarLogo` fournit le logo de navigation intégré de la console et du portail. `DarkAppBarLogo` est l'image de remplacement lorsque leur thème sombre est actif, et non une demande d'assombrir l'image d'origine. Définissez les deux URL de logo. Choisissez une image claire sur fond sombre pour le logo de remplacement. Ce paramètre ne sélectionne pas une image de page de connexion différente : `LoginPageImage` est partagée par les deux thèmes de connexion. | Paramètre | Quoi fournir | | ---------------------- | --------------------------------------------------------------------------------------------------------- | | `LoginPageTitle` | Titre de la page de connexion, par exemple `Contoso Automation`. Alias : `Title`. | | `LoginPageText` | Titre à l'intérieur de la carte de connexion, par exemple `Sign in with your work account`. | | `LoginPageDescription` | Texte près du logo, par exemple une courte description du public ou du service. | | `LoginPageImage` | URL du logo de connexion, par exemple `/branding/logo.png`. Alias : `Image`. | | `LoginPageLogoSize` | Une largeur CSS, comme `180px`, `12rem` ou `50%`. La largeur par défaut du logo personnalisé est `128px`. | | `AppBarLogo` | URL du logo régulier de la console et du portail. | | `DarkAppBarLogo` | URL du logo de navigation de remplacement utilisé dans le thème sombre. | | `Favicon` | URL de l'icône d'onglet du navigateur, par exemple `/branding/favicon.ico`. | | `AdminConsoleTitle` | Suffixe du titre de navigateur de la console d'administration. | | `PortalTitle` | Titre utilisé par les pages de recherche de ressources et de scripts du portail. | | `Copyright` | Texte de droit d'auteur sur la page de connexion et partout où le pied de page intégré est affiché. | ## Exemple : disposition, thème et couleurs de connexion Pour placer le logo et la description à côté de la carte de connexion, changez le profil pour `Horizontal`. `Vertical` empile l'image de marque au-dessus de la carte. La disposition horizontale peut s'empiler sur les écrans étroits. ```powershell $branding.LoginPageLayout = 'Horizontal' $branding.LoginPageTheme = 'Light' $branding.LoginPageBackgroundColor = '#E8F0F8' $branding.LoginPageFontColor = '#172B4D' Set-PSUBranding @branding ``` Ces lignes supposent que `$branding` de l'exemple précédent est encore défini. Pour un fichier de configuration, ajoutez les affectations avant son unique appel final `Set-PSUBranding @branding`, plutôt que d'ajouter une seconde définition d'image de marque. | Paramètre | Valeurs et effet | | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `LoginPageLayout` | `Vertical` (par défaut) ou `Horizontal`. | | `LoginPageTheme` | `System` (par défaut), `Light` ou `Dark`. Utilisez `System`, et non `Auto`. Le mode System tient compte de la préférence de thème PSU enregistrée du navigateur, sinon de la préférence de couleur du système d'exploitation. | | `LoginPageBackgroundColor` | Couleur CSS utilisée pour l'arrière-plan de la disposition de connexion et pour l'arrière-plan et la bordure du bouton de connexion principal. Elle ne retire pas une image d'arrière-plan intégrée et ne change pas la couleur du texte du bouton. | | `LoginPageFontColor` | Couleur CSS appliquée à la typographie de la page de connexion. Ce n'est pas un paramètre distinct de couleur d'étiquette de bouton ou de texte de champ. | Utilisez des combinaisons de premier plan et d'arrière-plan lisibles, et vérifiez le logo, la description, les boutons et les messages d'erreur dans les thèmes qu'utilisent vos utilisateurs. `LoginPageTheme` contrôle la page de connexion, et non les préférences de thème de console des utilisateurs. ## Exemple : couleurs de navigation et de carte Étendez le même profil avec ces valeurs : ```powershell $branding.SecondaryColor = '#16324F' $branding.SecondaryFontColor = '#FFFFFF' $branding.PrimaryColor = '#FFFFFF' $branding.PrimaryFontColor = '#172B4D' Set-PSUBranding @branding ``` Les couleurs secondaires ciblent la navigation intégrée de l'administration et du portail. La paire de couleurs principales est utilisée par les cartes intégrées, comme la carte de réinitialisation du mot de passe; ce n'est pas la palette principale Material UI des applis, et elle ne recolore pas chaque contrôle de la console. Définissez `PrimaryColor` avec `PrimaryFontColor`, car ces remplacements de carte sont appliqués ensemble. | Paramètre | Portée | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | `SecondaryColor` | Arrière-plan de la navigation et du menu latéral. | | `SecondaryFontColor` | Couleur de premier plan héritée de la navigation; les styles de composant peuvent fournir des couleurs plus spécifiques. | | `PrimaryColor` | Arrière-plan des cartes intégrées qui utilisent la couleur d'image de marque principale. | | `PrimaryFontColor` | Premier plan associé à `PrimaryColor` sur ces cartes. | | `HeaderColor`, `HeaderFontColor` | Paramètres de compatibilité pour les anciennes dispositions d'en-tête. La disposition actuelle de la console n'applique pas ces valeurs. | ## Exemple : personnaliser la feuille de style de connexion Utilisez `LoginPageCssStylesheet` lorsque les paramètres de connexion intégrés ne suffisent pas. Par exemple, pour remplacer l'image d'arrière-plan intégrée par une couleur unie et définir une couleur de bouton indépendante, enregistrez ce qui suit sous `C:\PSU\Branding\login.css` : ```css html body .ant-layout { background-image: none !important; background-color: #E8F0F8 !important; } html body .ant-btn-primary { background-color: #0066B0 !important; border-color: #0066B0 !important; color: #FFFFFF !important; } ``` Référencez l'URL publiée dans le même profil d'image de marque : ```powershell $branding.LoginPageCssStylesheet = '/branding/login.css' Set-PSUBranding @branding ``` Cette feuille de style est chargée sur les pages de connexion et d'erreur de connexion. Elle ne stylise pas globalement la console d'administration ni vos applis. L'exemple utilise des sélecteurs plus spécifiques et `!important` pour remplacer les styles de connexion intégrés. Les sélecteurs CSS sont des détails d'implémentation : revérifiez les styles personnalisés après une mise à niveau de PSU. N'utilisez que des feuilles de style fiables servies en HTTPS ou à partir de votre propre instance PSU. Si un changement n'apparaît pas, inspectez la requête de feuille de style dans les outils de développement du navigateur, puis actualisez sans le cache. Une URL versionnée telle que `/branding/login.css?v=2` peut aider lors du déploiement d'un fichier mis à jour. ## Exemple : messages d'erreur et de déconnexion conviviaux Ajoutez ces entrées au profil avant de l'appliquer : ```powershell $branding.PageNotFoundTitle = 'Page not found' $branding.PageNotFoundDescription = 'Check the address or return to the home page.' $branding.NotAuthorizedTitle = 'Access required' $branding.NotAuthorizedDescription = 'Contact the service desk to request access.' $branding.AppNotRunningDescription = 'This service is temporarily unavailable. Please try again later.' $branding.LoggedOut = 'You are signed out' $branding.LoggedOutDescription = 'Close your browser if you are using a shared computer.' Set-PSUBranding @branding ``` | Paramètre | Où il est utilisé | | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `PageNotFoundTitle`, `PageNotFoundDescription` | Écran intégré de page introuvable. | | `NotAuthorizedTitle`, `NotAuthorizedDescription` | Écran intégré d'accès non autorisé. | | `AppNotRunningDescription` | Écran de l'infrastructure d'appli affiché lorsqu'une appli n'est pas en cours d'exécution. Il est distinct de l'écran de démarrage ou de chargement du serveur. | | `LoggedOut`, `LoggedOutDescription` | Titre et description sur l'écran intégré `/loggedout`. | Ces paramètres changent la présentation, et non les règles d'accès. Ils n'accordent pas de permissions, n'activent pas de fournisseurs d'authentification, ne démarrent pas une appli et ne changent pas la gestion des erreurs HTTP dans un proxy inverse. Gardez les messages exempts de secrets et d'informations de diagnostic internes. ## Paramètres de compatibilité La référence de l'applet de commande comprend des paramètres conservés dans le modèle d'image de marque que les dispositions de page intégrées actuelles n'utilisent pas : | Paramètre | Comportement de compatibilité | | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `LoginPageLinks` | Accepte des objets `LoginPageLink`, mais les modèles de connexion verticaux et horizontaux actuels ne les affichent pas. | | `CssStylesheet` | Accepte un tableau d'URL de feuilles de style, mais la console d'administration actuelle ne les charge pas comme feuilles de style globales. Utilisez `LoginPageCssStylesheet` pour la page de connexion. | | `CssStylesheetIntegrity` | Valeurs d'intégrité associées pour `CssStylesheet`; cela n'ajoute pas d'attribut d'intégrité à `LoginPageCssStylesheet`. | | `HeaderColor`, `HeaderFontColor` | Conservé pour la compatibilité; la disposition actuelle de la console, basée sur la navigation, n'affiche pas l'ancien en-tête à l'image de marque. | Le rendu dépend de la version de PSU et de la disposition de la page. Le fait qu'un paramètre soit accepté et enregistré ne prouve pas qu'un élément visible l'utilise. Vérifiez la page concernée plutôt que d'ajouter d'autres paramètres pour compenser un paramètre inutilisé. ## Réinitialiser et résoudre les problèmes Pour réinitialiser l'image de marque, sélectionnez **Réinitialiser** dans **Paramètres > Image de marque** et confirmez. Cela remplace la définition enregistrée par les valeurs par défaut. L'appel d'applet de commande interactif équivalent est : ```powershell Set-PSUBranding ``` Si la configuration est gérée par Git ou un autre processus de déploiement, mettez aussi cette source à jour afin qu'elle ne réapplique pas l'ancienne image de marque. La réinitialisation de l'image de marque ne supprime pas les fichiers d'image ou de feuille de style publiés. | Symptôme | Quoi vérifier | | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Le logo ou le CSS ne se charge pas avant la connexion | Ouvrez l'URL exacte dans une fenêtre de navigation privée. Vérifiez le chemin du dossier publié, l'accès en lecture du compte de service et le fait que l'actif n'est pas protégé par l'authentification ou des rôles. | | Le navigateur demande le mauvais site ou le mauvais chemin | Les paramètres d'image doivent être des URL, et non des chemins de système de fichiers. Incluez tout préfixe de chemin d'hébergement. Une page de connexion HTTPS ne doit pas dépendre d'actifs HTTP. | | Les paramètres précédents disparaissent après un autre exemple | Incluez tous les paramètres voulus dans une seule table de hachage ou définition d'image de marque; les appels d'applet de commande remplacent la définition. | | La couleur d'arrière-plan change, mais le motif demeure | Le paramètre de couleur ne retire pas l'image d'arrière-plan. Utilisez l'exemple de feuille de style si vous voulez un arrière-plan uni. | | La valeur de thème est rejetée | Utilisez `System`, `Light` ou `Dark`, et non `Auto`. | | Un paramètre valide n'a aucun effet visible | Vérifiez la portée du paramètre et les notes de compatibilité, actualisez le navigateur et confirmez que la configuration voulue a été chargée. | | La favicône ou la feuille de style semble toujours inchangée | Vérifiez la réponse réseau et le cache du navigateur; utilisez au besoin une URL d'actif avec version. | ## API * [Set-PSUBranding](/powershell-universal/fr/commandes-powershell/set-psubranding.md) * [New-PSUBranding](/powershell-universal/fr/commandes-powershell/new-psubranding.md) (alias) * [New-PSUPublishedFolder](/powershell-universal/fr/commandes-powershell/new-psupublishedfolder.md) --- # 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/fr/config/login-page.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.