Set-PSUBranding
Synopsis
Angiver branding for PowerShell Universal.
Syntaks
Set-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>] [-ComputerName <String>] [-AppToken <String>]
[-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Beskrivelse
Opdaterer brandingindstillinger for portalen, logonsiden og admin console i PowerShell Universal. New-PSUBranding og New-PSULoginPage er aliaser for denne cmdlet.
Hvert kald erstatter brandingdefinitionen i stedet for kun at flette de angivne parametre. Medtag alle indstillinger, De vil bevare. Når den evalueres i .universal\branding.ps1, opretter cmdlet'en det konfigurationsobjekt, som PSU skal indlæse. Uden for indlæsning af konfiguration bruger den definitionen på den tilsluttede server og returnerer den.
Se Branding for komplette eksempler, offentlig hosting af aktiver, logonlayouts, farver, CSS, fejlmeddelelser og kompatibilitetsnoter.
Eksempler
Eksempel 1: angiv logoer og konsoltitlen
Angiver logonbilledet, navigationslogoet og suffikset til browsertitlen i Admin Console. Publicer først billedet på den angivne URL. Billedparametre accepterer URL'er, der kan tilgås i browseren, ikke filsystemstier på serveren. Aktiver, der skal bruges før logon, skal tillade anonym adgang. Dette kald erstatter enhver eksisterende brandingdefinition.
Eksempel 2: behold en komplet brandingprofil
Holder relaterede indstillinger samlet, så anvendelse af profilen ikke udelader tidligere værdier. Brug System, Light eller Dark til temaet og Vertical eller Horizontal til layoutet.
Parametre
-AdminConsoleTitle
Browser-titelsuffikset for Admin Console. En udviklerlicens bruger i stedet udviklingstitlen.
-AppBarLogo
URL'en til det almindelige logo, der skal bruges i den indbyggede konsol og portalnavigationen.
-AppNotRunningDescription
Teksten, der skal vises på app-frameworkets skærm, når appen ikke kører, ikke serverens opstarts-/indlæsningsskærm.
-AppToken
Det AppToken, der bruges til at kalde PowerShell Universal Management API. De kan også kalde Connect-PSUServer, før De kalder denne cmdlet, for at angive AppToken for hele sessionen.
-ComputerName
Angiver det computernavn eller den URL, der skal kaldes, når PowerShell Universal Management API tilgås. De kan også bruge Connect-PSUServer, før De kalder denne cmdlet, for at angive computernavnet for hele sessionen.
-Copyright
Ophavsretsteksten på logonsiden og den indbyggede sidefod, hvor den gengives.
-Credential
Legitimationsoplysninger til at logge på PowerShell Universal Management API.
-CssStylesheet
Kompatibilitetsparameter, der indeholder URL'er til branding-typografiark. Den aktuelle Admin Console indlæser ikke disse som globale typografiark. Til CSS på logonsiden skal De bruge -LoginPageCssStylesheet.
-CssStylesheetIntegrity
Ledsagende integritetsværdier for -CssStylesheet. Dette tilføjer ikke en integritetsattribut til -LoginPageCssStylesheet.
-Favicon
Den URL eller tekst, der skal bruges til ikonet på systemets browserfane. Branding er den konfigurerbare kilde til systemets favicon; hvis den ikke er angivet, bruges standarden.
HTTP- og HTTPS-URL'er kan være uden udvidelse. Relative billedplaceringer skal bruge en sti (f.eks. /branding/icon, ./images/icon eller images/icon) eller et filnavn med en billedudvidelse (f.eks. favicon.ico). Andre værdier gengives som SVG-tekst.
-HeaderColor
Kompatibilitetsindstilling for ældre headerlayouts. Det aktuelle konsollayout bruger den ikke.
-HeaderFontColor
Kompatibilitetsindstilling for ældre headerlayouts. Det aktuelle konsollayout bruger den ikke.
-Integrated
Anmoder om integreret adgang til administrations-API'en, når det tillades af serverens API-sikkerhedsmodel.
-LoggedOut
Titlen på den indbyggede logaf-skærm.
-LoggedOutDescription
Beskrivelsen på den indbyggede logaf-skærm.
-LoginPageDescription
Den beskrivelse, der skal vises ved logonlogoet.
-LoginPageImage
URL'en til det billede, der skal bruges på logonsiden. Publicer aktivet, så ikke-godkendte browsere kan indlæse det; denne parameter læser ikke en lokal serverfil.
-LoginPageLinks
Kompatibilitetsparameter, der accepterer links til logonsiden. De aktuelle lodrette og vandrette logonskabeloner gengiver ikke disse links.
-LoginPageText
Overskriften inde i logonkortet.
-LoginPageTitle
Logonsidens titel og browser-titelsuffikset. I det aktuelle logonlayout gengives den synlige brugerdefinerede titel under logoet, når der er angivet et brugerdefineret -LoginPageImage.
-NotAuthorizedDescription
Beskrivelsen, der skal vises, når brugeren ikke er autoriseret.
-NotAuthorizedTitle
Titlen, der skal vises, når brugeren ikke er autoriseret.
-PageNotFoundDescription
Den beskrivelse, der skal vises, når siden ikke findes.
-PageNotFoundTitle
Den titel, der skal vises, når siden ikke findes.
-PrimaryColor
Baggrundsfarve til indbyggede kort, der bruger den primære brandingfarve, f.eks. reset-password-kortet. Dette er ikke en paletteindstilling for Material UI i en app.
-PrimaryFontColor
Forgrundsfarve, der er parret med -PrimaryColor på indbyggede kort. Angiv begge værdier sammen.
-SecondaryColor
Baggrundsfarve for navigationen/sidepanelet i den indbyggede admin og portal.
-SecondaryFontColor
Nedarvet forgrundsfarve for den indbyggede navigation. Mere specifikke komponenttypografier kan tilsidesætte den.
-TrustCertificate
Om cmdlet'en skal ignorere certifikatproblemer.
-UseDefaultCredentials
Om cmdletten skal bruge standardlegitimationsoplysningerne.
-DarkAppBarLogo
URL'en til det alternative navigationslogo, der bruges, når mørkt tema er aktivt. Angiv også -AppBarLogo. Dette ændrer ikke logonbilledet.
-LoginPageTheme
Temapræferencen for logonsiden: System, Light eller Dark. Standardværdien er System, ikke Auto. Systemtilstand tager hensyn til browserens gemte PSU-temapræference og ellers til operativsystemets farvepræference. Dette angiver ikke temaet for konsollen efter logon.
-PortalTitle
Den titel, der bruges af portalens ressourcesøgning og scriptsider.
-LoginPageCssStylesheet
En stylesheet-URL, der indlæses på logonsiden og login-error-siden. Den typograferer ikke konsollen eller apps globalt.
-LoginPageLayout
Logonsidens layout: Vertical (standard) eller Horizontal. Det vandrette layout kan stables på smalle skærme.
-LoginPageBackgroundColor
Baggrundsfarven for logonlayoutet og baggrunds- og kantfarven for den primære logonknap. Dette fjerner ikke et indbygget baggrundsbillede og angiver ikke tekstfarven på knappen.
-LoginPageFontColor
Farven på typografien på logonsiden, ikke en separat farveindstilling for inputtekst eller knapetiket.
-LoginPageLogoSize
Bredden på det brugerdefinerede logonlogo. Pixel, procenter og andre gyldige CSS-bredder er tilladt; for eksempel 180px. Når den ikke er angivet, bruger et brugerdefineret logonbillede en bredde på 128px.
-Cookies
Genbruger og bevarer godkendelsescookies for den aktuelle PowerShell-session.
CommonParameters
Denne cmdlet understøtter de fælles parametre: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable og -ProgressAction. Se about_CommonParameters for at få flere oplysninger.
Input
Ingen
Output
System.Object
Noter
Relaterede links
Tilladelser
Adgangstokenet kræver settings.branding/update for at køre denne cmdlet eksternt.
Sidst opdateret
Var dette nyttigt?