WinGet-konfiguration

Med hjälp av en WinGet-konfigurationsfil kan du konsolidera manuell datorkonfiguration och projektregistrering till ett enda kommando som är tillförlitligt och repeterbart. För att uppnå detta använder WinGet:

• En YAML-formaterad WinGet-konfigurationsfil som visar alla programvaruversioner, paket, verktyg, beroenden och inställningar som krävs för att konfigurera det önskade tillståndet för utvecklingsmiljön på din Windows-dator.
• PowerShell Desired State Configuration (DSC) för att automatisera konfigurationen av ditt Windows-operativsystem.
• Kommandot Windows Package Managerwinget configure för att initiera konfigurationsprocessen.

Fördelar med maskininstallation och projektregistrering

Fördelarna med att använda en WinGet-konfigurationsfil är:

• Obevakad installation: Ange winget configure kommandot och låt Windows Package Manager och PowerShell DSC automatisera installationen och konfigurera alla krav som krävs för att få önskad utvecklingsmiljö konfigurerad på din Windows-dator.
• Tillförlitlig och repeterbar: Ta bort oron för att hitta rätt versioner av programvara, paket, verktyg, ramverk och konfigurera rätt datorinställningar för utvecklingsmiljön när du registrerar dig för ett nytt team eller projekt eftersom de är fördefinierade i WinGet-konfigurationsfilen med ett YAML-format (med ett JSON-schema).
• Stöder samarbete med öppen källkod: WinGet-konfigurationsfiler kan finnas på en GitHub-lagringsplats där problem eller bidrag kan arkiveras eller kan hållas privata på en säker lagringsplats (till exempel OneDrive) och delas via privat e-post eller andra skyddade kanaler.

Varning

WinGet-konfigurationsfiler och eventuella associerade PowerShell DSC-resurser bör kontrolleras för att säkerställa att de är tillförlitliga innan de tillämpas.

Använda en WinGet-konfigurationsfil för att konfigurera datorn

Om du vill konfigurera datorn med en WinGet-konfigurationsfil laddar du ned konfigurationsfilen och dubbelklickar för att anropa konfigurationen. Du kan också använda winget configure på kommandoraden. Om du vill använda winget configure kommandot måste du köra WinGet-version v1.6.2631 eller senare.

Vanliga frågor och svar om WinGet-konfiguration

Hitta svar på några av de vanligaste frågorna om WinGet Configuration.

Hur fungerar WinGet-konfigurationsfiler?

WinGet-konfigurationsfiler skrivs i YAML och definierar vad som är installerat på enheten för att utgöra utvecklingsmiljön, samt konfigurationstillståndet för datorn och installerade program.

I stället för en imperativ sekvens med steg som ska följas är en WinGet-konfigurationsfil deklarativ och definierar resultatet för önskad datorkonfigurationstillstånd. Genom att använda Windows Package Manager och PowerShell DSC-resurser kan den deklarativa WinGet-konfigurationsfilen installera, konfigurera och tillämpa inställningar för din miljö, vilket resulterar i ett kodklart tillstånd.

WinGet parsar konfigurationsfilen för att säkerställa att den är giltig och laddar sedan ned alla associerade PowerShell-moduler (som innehåller DSC-resurserna) som krävs för att uppnå önskat tillstånd. När dessa resurser har laddats ned och du har kontrollerat tillförlitligheten för WinGet-konfigurationsfilen, och godkänner att du har verifierat filens säkerhet, börjar WinGet testa alla nödvändiga påståenden och tillämpa önskat tillstånd.

Sekvensen där WinGet-konfigurationsfilresurserna sorteras är oviktig. Vissa installations- och konfigurationsprocesser kan till och med köras parallellt. De specificerade påståendena motsvarar direkt detta dependsOn-fält som definierats i varje -resurs. Om resursen innehåller ett beroende av en försäkran kontrolleras försäkran först. Om försäkran misslyckas misslyckas även den beroende resursen. Konfigurationsfilen fortsätter dock att köras och utför så många uppgifter som möjligt, även om några av villkoren eller resursberoendena misslyckas, vilket tar din maskin så långt som möjligt i konfigurationsprocessen innan det är klart. När konfigurationen har slutförts är det ditt ansvar att söka efter eventuella fel.

När du har kört WinGet-konfigurationsfilen kan du till exempel se ett resultat som:

Assert:: OsVersion
The configuration unit could not be found.
Apply :: DeveloperMode
  This configuration unity was not run because an assert failed or was false.
Apply :: WinGetPackage [vsPackage]
  This configuration unity was not run because an assert failed or was false.

I det här exemplet misslyckades kontrollen av den nödvändiga versionen av operativsystemet, så resurserna DeveloperMode och WinGetPackage som inkluderade ett beroende av den försäkran för operativsystemversionen misslyckades också. Andra installations- och konfigurationsuppgifter som anges i konfigurationsfilen fortsätter dock att gå framåt.

En fördel med winget-konfigurationsfilernas deklarativa (icke-sekventiella) karaktär är att positionen för nya resurser som läggs till i filen inte spelar någon roll. Detta är särskilt användbart för långa konfigurationsfiler eftersom du bara kan lägga till ytterligare resurser längst ned i filen. Så länge du har definierat försäkran och beroenden korrekt behöver du inte bry dig om sekvensen, eller vilka steg som ska utföras först, andra osv.

Hur använder jag en WinGet-konfigurationsfil?

Om du vill köra en WinGet-konfigurationsfil kan du helt enkelt dubbelklicka för att köra filen i Utforskaren. Du kan också använda winget configure kommandot .

Hur skapar jag en WinGet-konfiguration?

Om du vill skapa en WinGet-konfigurationsfil följer du riktlinjerna i dokumentet Så här skapar du en WinGet-konfigurationsfil .

Hur kan jag försäkra mig om att en WinGet-konfigurationsfil är tillförlitlig?

Vi rekommenderar att DU ALLTID verifierar integriteten för en WinGet-konfigurationsfil innan du kör den genom att granska dess innehåll och testa konfigurationen i en isolerad miljö. Se Så här kontrollerar du tillförlitligheten för en WinGet-konfigurationsfil.

Var hittar jag WinGet-exempelkonfigurationsfiler?

Du hittar WinGet-konfigurationsfiler i WinGet DSC-lagringsplatsen: https://aka.ms/dsc.yaml.

Var hittar jag exempel på PowerShell-moduler som innehåller DSC-resurser?

PowerShell-galleriet är värd för hundratals PowerShell-moduler som innehåller DSC-resurser (Desired State Configuration). Du kan filtrera sökresultat genom att använda filtret "DSC-resurs" under "Kategorier".

Kan jag konfigurera en princip för att blockera användningen av WinGet-konfigurationsfiler i min organisation?

Ja. GrupprincipobjektEnableWindowsPackageManagerConfiguration och EnableWindowsPackageManagerConfigurationExplanation kan användas för att inaktivera WinGet-konfigurationsfunktionen i din organisation.

Felsöka WinGet-konfigurationer

Den vanligaste orsaken till att en WinGet-konfiguration misslyckas beror på att en PowerShell DSC-resurs kräver administrativ åtkomst för att tillämpa önskat tillstånd. Inte alla DSC-resurser har explicita förklaringar till fel.

Vanligare felsökningsproblem kommer snart att läggas till. Under tiden kontrollerar du de relaterade problem som har lämnats in i WinGet CLI-lagringsplatsen på GitHub.