For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

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.

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.

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

Tilladelser

Adgangstokenet kræver settings.branding/update for at køre denne cmdlet eksternt.

Sidst opdateret

Var dette nyttigt?