dotnet workload install

Dit artikel is van toepassing op: ✔️ .NET 6 SDK en latere versies

Naam

dotnet workload install - Installeert optionele workloads.

Samenvatting

dotnet workload install <WORKLOAD_ID>...
    [--configfile <FILE>] [--disable-parallel]
    [--ignore-failed-sources] [--include-previews] [--interactive]
    [--no-cache] [--skip-manifest-update] [--source <SOURCE>]
    [--temp-dir <PATH>] [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet workload install -?|-h|--help

Beschrijving

Met de dotnet workload install opdracht worden een of meer optionele workloads geïnstalleerd. Optionele workloads kunnen worden geïnstalleerd boven op de .NET SDK om ondersteuning te bieden voor verschillende toepassingstypen, zoals .NETLOAD en Blazor WebAssembly AOT.

Wanneer de opdracht zich in workload-set de updatemodus bevindt, zijn de workloadversies geïnstalleerd:

• Zijn afkomstig van de meest recente workloadset of een versie van een workloadset die is opgegeven in een global.json of --version optie.
• Mogelijk is dit niet de meest recente versie van elke afzonderlijke workload. Met de install opdracht wordt bijvoorbeeld geen nieuwere workloadset geïnstalleerd als u de --version vlag eerder hebt gebruikt.

Zie .NET SDK-workloadsets voor meer informatie. workload-set updatemodus is beschikbaar sinds 8.0.400 SDK.

Gebruik dotnet-workloadzoekopdrachten om te leren welke workloads beschikbaar zijn om te installeren.

Wanneer moet u verhoogde bevoegdheden uitvoeren

Voor macOS- en Linux SDK-installaties die zijn geïnstalleerd in een beveiligde map, moet de opdracht verhoogde bevoegdheden uitvoeren (gebruik de sudo opdracht). In Windows hoeft de opdracht niet verhoogd te worden uitgevoerd, zelfs niet als de SDK is geïnstalleerd in de map Program Files . Voor Windows gebruikt de opdracht MSI-installatieprogramma's voor die locatie.

Resultaten variëren per SDK-versie

De dotnet workload opdrachten worden uitgevoerd in de context van specifieke SDK-versies. Stel dat u zowel .NET 6.0.100 SDK als .NET 6.0.200 SDK hebt geïnstalleerd. De dotnet workload opdrachten geven verschillende resultaten, afhankelijk van de SDK-versie die u selecteert. Dit gedrag is van toepassing op primaire en secundaire versie en functiebandverschillen, niet op patchversieverschillen. .NET SDK 6.0.101 en 6.0.102 geven bijvoorbeeld dezelfde resultaten, terwijl 6.0.100 en 6.0.200 verschillende resultaten geven. U kunt de SDK-versie opgeven met behulp van het global.json-bestand.

Reclamemanifesten

De namen en versies van de assets die een workloadinstallatie vereist, worden onderhouden in manifesten. Standaard downloadt de dotnet workload install opdracht de meest recente beschikbare manifesten voordat een workload wordt geïnstalleerd. De lokale kopie van een manifest bevat vervolgens de informatie die nodig is om de assets voor een workload te zoeken en te downloaden.

Met dotnet workload list de opdracht worden de versies van geïnstalleerde workloads vergeleken met de momenteel beschikbare versies. Wanneer wordt gevonden dat een nieuwere versie dan de geïnstalleerde versie beschikbaar is, wordt dat feit in de uitvoer van de opdracht aangekondigd. Deze meldingen dotnet workload list van nieuwere versies zijn beschikbaar vanaf .NET 6.

Als u deze meldingen wilt inschakelen, worden de nieuwste beschikbare versies van de manifesten gedownload en opgeslagen als reclamemanifesten. Deze downloads worden asynchroon op de achtergrond uitgevoerd wanneer een van de volgende opdrachten wordt uitgevoerd.

• dotnet-build
• dotnet pack
• dotnet publish
• dotnet herstellen
• dotnet-uitvoering
• dotnet-test

Als een opdracht is voltooid voordat het downloaden van het manifest is voltooid, wordt het downloaden gestopt. Het downloaden wordt opnieuw geprobeerd de volgende keer dat een van deze opdrachten wordt uitgevoerd. U kunt omgevingsvariabelen instellen om deze downloads op de achtergrond uit te schakelen of hun frequentie te beheren. Ze gebeuren standaard niet meer dan één keer per dag.

U kunt voorkomen dat de dotnet workload install opdracht manifestdownloads uitvoert met behulp van de --skip-manifest-update optie.

Met de dotnet workload update opdracht worden ook advertentiemanifesten gedownload. De downloads zijn vereist om te leren of er een update beschikbaar is, dus er is geen optie om te voorkomen dat ze worden uitgevoerd. U kunt echter de --advertising-manifests-only optie gebruiken om werkbelastingupdates over te slaan en alleen de manifestdownloads uit te voeren. Deze optie is beschikbaar vanaf .NET 6.

Argumenten

• WORKLOAD_ID...

  De workload-id of meerdere id's die moeten worden geïnstalleerd. Gebruik dotnet-workloadzoekopdrachten om te leren welke werkbelastingen beschikbaar zijn.

Opties

• --configfile <FILE>

  Het NuGet-configuratiebestand (nuget.config) dat moet worden gebruikt. Indien opgegeven, worden alleen de instellingen uit dit bestand gebruikt. Als dit niet is opgegeven, wordt de hiërarchie van configuratiebestanden uit de huidige map gebruikt. Zie Algemene NuGet-configuraties voor meer informatie.

• --disable-parallel

  Hiermee voorkomt u dat meerdere projecten parallel worden hersteld.

• -?|-h|--help

  Hiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

• --ignore-failed-sources

  Behandelt pakketbronfouten als waarschuwingen.

• --include-previews

  Hiermee staat u prerelease van workloadmanifesten toe.

• --interactive

  Hiermee kan de opdracht stoppen en wachten op invoer of actie van de gebruiker. Bijvoorbeeld om de verificatie te voltooien.

• --no-cache

  Hiermee voorkomt u dat pakketten en HTTP-aanvragen in de cache worden opgeslagen.

• --skip-manifest-update

  Sla het bijwerken van de workloadmanifesten over. De workloadmanifesten definiëren welke assets en versies voor elke workload moeten worden geïnstalleerd.

• -s|--source <SOURCE>

  Hiermee geeft u de URI van de NuGet-pakketbron te gebruiken. Deze instelling overschrijft alle bronnen die zijn opgegeven in de nuget.config-bestanden . U kunt meerdere bronnen opgeven door deze optie meerdere keren op te geven.

• --temp-dir <PATH>

  Geef de tijdelijke map op die wordt gebruikt voor het downloaden en extraheren van NuGet-pakketten (moet veilig zijn).

• -v|--verbosity <LEVEL>

  Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , n[ormal]en diag[nostic]d[etailed]m[inimal]. De standaardwaarde is minimal. Als u opgeeft detailed of diagnostic uitgebreid bent, geeft de opdracht informatie weer over de Nuget-pakketten die worden gedownload.

• --version

  De versie van de workloadset die moet worden geïnstalleerd of bijgewerkt. Als u de versie van de workloadset opgeeft in global.json, kunt u de --version optie niet gebruiken om de versie van de workloadset op te geven. Als u de optie in dat geval wilt gebruiken, voert u de --version opdracht buiten het pad met het global.json-bestand uit. Beschikbaar sinds 8.0.400 SDK. Zie .NET SDK-workloadsets voor meer informatie.

Voorbeelden

• Installeer de maui workload:

  dotnet workload install maui
  

• Installeer de maui-android en maui-ios workloads:

  dotnet workload install maui-android maui-ios