For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Spring til indhold

Azure

PowerShell Universal er et ASP.NET Core-webprogram og kan hostes i Windows Azure Web Apps.

Webapp i en container

Containerwebapps gør det muligt at bruge Docker-images som webapps i Azure. I Azure-portalen kan De oprette en Docker Container-webapp ved hjælp af guiden App Services \ Create Web App.

Når De har valgt en ressourcegruppe, tildelt et navn og valgt en beregningsplan, kan De oprette webappen.

Dernæst skal De udrulle imaget til Deres web-app. Det gør De ved at vælge Deployment Center og konfigurere det image, der skal hentes. De kan enten hente en version med et fast tag (f.eks. 2.7.3) eller hente den seneste, så Deres web-app holdes automatisk ajour med nye PowerShell Universal-udgivelser. Brug tagget med suffikset azure. Det er forudkonfigureret til at køre i Azure.

I produktionsmiljøer foreslår vi at angive en tagget version for at undgå utilsigtede opdateringer af Deres container, når den genstartes. Som standard opdaterer Azure automatisk containere, når et tag, f.eks. latest, opdateres. Dette giver Dem mulighed for at styre opdateringer af Deres PowerShell Universal-version.

Lokal persistens

Som standard skriver containeren til mappen /home.

De skal sikre, at miljøvariablen WEBSITES_ENABLE_APP_SERVICE_STORAGE er angivet til true. Dette konfigurerer objektbeholderen, så mappen /home er vedvarende, og det er her, konfigurationsdataene for PowerShell Universal gemmes.

Git og SQL

Hvis De vælger at bruge git-integration i PowerShell Universal, anbefaler vi at opsætte en SQL-server og en database til lager. Git bruges til at synkronisere konfigurationsfiler, når containeren startes. SQL gemmer git-konfigurationsindstillingerne sammen med ressourcer som job, app-tokens og identiteter.

De skal bruge en Azure SQL-database for at komme i gang. Når De har oprettet ressourcen, skal De kopiere forbindelsesstrengen fra databasen for at angive den til PowerShell Universal.

Sørg for, at De har tilladt Azure-tjenester at få adgang til databasen.

For at aktivere SQL-understøttelse bør De angive plugins i PowerShell Universal til at bruge SQL-pluginnet i programkonfigurationen for Deres webapp.

Opret en Plugins__0-indstilling med værdien SQL. Angiv derefter værdien af Data__ConnectionString til Deres SQL Server-database.

Når De har konfigureret SQL, kan De starte Deres container. Databaseskemaet oprettes, når containeren starter. Dernæst skal De konfigurere git i PowerShell Universal ved at klikke på Source Control > Git > Settings. Angiv Deres fjernlager, gren, brugernavn, adgangskode eller personligt adgangstoken og synkroniseringstilstand. Push-only anbefales ikke i denne konfiguration, fordi containerens tilstand går tabt mellem genstarter. Sørg for, at initialiseringstilstanden er angivet til Clone.

Git-indstillinger gemmes i Deres SQL-database og hentes, hver gang containeren startes.

Videresendte headere

Containere er typisk hostet bag en omvendt proxy og kender ikke den faktiske eksterne URL uden yderligere konfiguration. For at sikre, at systemer, der kræver den eksterne URL, f.eks. OpenID Connect, modtager de rette oplysninger, skal De angive miljøvariablen ASPNETCORE_FORWARDEDHEADERS_ENABLED til true.

Yderligere oplysninger kan De læse i dette blogindlæg fra Microsoft.

Bicep

De kan bruge følgende Bicep-skabelon til at udrulle en webapp i en container med vedvarende lager.

Container-sidecars

Webapps i containere understøtter også sidecar-containere, så De kan køre yderligere containere ved siden af PowerShell Universal-containeren. Det er nyttigt til understøttende tjenester som proxyer, agenter, indsamlere eller andre ledsagende processer. Når De hoster PowerShell Universal i denne konfiguration, skal De sikre, at webcontaineren eksponerer den korrekte HTTP-port. Som standard lytter PowerShell Universal på port 5000.

Standardwebapp

Manuel oprettelse af en webapp

I Azure Portal skal De oprette en ny Web App-ressource. PowerShell Universal kræver i øjeblikket .NET 10-runtime-stakken. De kan bruge enten Linux eller Windows.

Hvis De vælger en Windows-hostingplan frem for en Linux-hostingplan i Azure, når De konfigurerer Deres WebApp, skal De vælge en Basic Plan (B1) eller højere for at kunne bruge 64-bit-apps. De skal også gå til Settings > Configuration > General setting > Platform og vælge 64-bit, før De kører kommandoen Publish-AzWebApp, ellers mislykkes installationen.

Startup Command (kun Linux)

Når De hoster i et Linux-miljø, skal De angive startkommandoen under Settings \ Configuration \ General Settings \ Startup Command til følgende.

I eksemplet nedenfor vil vi bruge Azure PowerShell-modulet til at udrulle Web App manuelt.

De skal først installere Azure PowerShell.

Når det er installeret, skal De oprette forbindelse til Deres abonnement.

Udrul Windows-filer

Hvis De bruger Windows, skal De downloade Windows ZIP-filen. Dette eksempel downloader PowerShell Universal 2026.3.0.0.

Udrul Linux-filer

Hvis De bruger Linux, skal De downloade Linux-ZIP-filen. Dette eksempel downloader PowerShell Universal 2026.3.0.0.

Nu hvor vi har konfigureret Az-modulet og downloadet Universal-ZIP-filen, kan vi udrulle Web App.

De kan kontrollere i Azure under Deployment Center > Logs efter Status Success (Active) for at sikre, at filer blev udrullet / installeret korrekt.

Nødvendige justeringer af indstillinger

Disse indstillinger kan angives i fanen Configuration under Application settings.

JWT-signeringsnøgle

Standard-JWT-signeringsnøglen er ikke tilstrækkelig lang og skal opdateres. Det kan gøres i appsettings.json eller ved hjælp af miljøvariabler.

appsettings.json

Miljøvariabel

API-URL

Azure Web Apps bruger en omvendt proxy, og PowerShell Universal registrerer ikke den eksterne URL hensigtsmæssigt. Når der køres job, bruger Universal Management API til automatisk at slå oplysninger om job, script og tidsplan op. Det betyder, at dette mislykkes, hvis den ikke kan adressere den eksterne API-URL korrekt.

API-URL'en skal være den eksterne HTTP-adresse for Deres Web App. De kan opdatere den i appsettings.json eller ved hjælp af en miljøvariabel.

appsettings.json

Miljøvariabel

NodeName

De kan angive navnet på PowerShell Universal-instansen ved at angive NodeName. Det sikrer, at genstarter ikke påvirker PowerShell Universal-databasen. Dette er ikke påkrævet for LiteDB-installationer.

PORT og WEBSITES_PORT (kun Linux)

For at tilsidesætte standardporten i en Linux-webapp skal De angive indstillingen PORT og WEBSITES_PORT til 5000.

Når De har publiceret Web App, skal De se Deres PowerShell Universal-instans ved at navigere til URL'en for Web App.

Vedvarende lager

Standardfilen appsettings.json gemmer databasen og konfigurationsfilerne på en ikke-vedvarende placering. De kan tilføje miljøvariabler for at flytte dem til vedvarende lager i Deres webapp.

Data__RepositoryPath

Miljøvariablen Data__RepositoryPath angiver placeringen af konfigurationsfilerne for Universal. Angiv værdien til følgende.

Opdatering af Deres Web App

Når en ny version af PowerShell Universal udgives, skal De opdatere programfilerne til Deres Web App. Vi anbefaler at fjerne programkataloget og udrulle filerne igen. Databasen og konfigurationsfilerne gemmes ikke i programkataloget.

De kan slette filerne til Deres Web App ved hjælp af Kudu-kommando-API'en. Deres Kudu-legitimationsoplysninger bruger Basic-godkendelse og er de samme som Deres udrulningslegitimationsoplysninger.

For at slette alle filerne i Deres Web App skal De køre følgende kommando.

Når De har slettet programfilerne, kan De udrulle dem igen ved at køre de manuelle oprettelsestrin igen.

Application Gateway

De kan konfigurere PowerShell Universal til at køre bag en Application Gateway i Azure. Det er nyttigt til at levere belastningsfordeling og høj tilgængelighed til flere PowerShell Universal-instanser.

Konfigurer først en backendpulje, der er rettet mod en eller flere Azure Web Apps, som kører PowerShell Universal.

For backendindstillingerne bør De sikre, at De bruger HTTPS med et velkendt CA-certifikat. Cookiebaseret affinitet er påkrævet for at sikre, at sessioner er bundet til en individuel node.

For at Azure kan levere den rigtige webapp, skal De sikre, at indstillingen Override with new host name er konfigureret. Brug værtsnavnet til backendmålet.

Sørg for, at backendpuljereglen er konfigureret som målet og ikke som omdirigering.

Konfigurer en omskrivningsregel for headeren, så det offentlige værtsnavn videregives som headeren X-Forwarded-Host. PowerShell Universal bruger denne til internt at opbygge URL'er.

Ovenstående omskrivningsregel er et krav for godkendelsesmetoderne OpenID Connect og SAML2.

Til sidst kan De konfigurere den offentlige IP-adresse for Deres Application Gateway ved hjælp af en DNS-udbyder til et brugerdefineret værtsnavn. Opret en A-post i Deres DNS-administration.

Sidst opdateret

Var dette nyttigt?