dotnet-toolupdate

2024-03-20

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

Naam

dotnet tool update - Werkt het opgegeven .NET-hulpprogramma op uw computer bij.

Samenvatting

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

Beschrijving

Met de dotnet tool update opdracht kunt u .NET-hulpprogramma's op uw computer bijwerken naar de nieuwste stabiele versie van het pakket. Met de opdracht wordt een hulpprogramma verwijderd en opnieuw geïnstalleerd, zodat deze effectief wordt bijgewerkt. Als u de opdracht wilt gebruiken, geeft u een van de volgende opties op:

Als u een algemeen hulpprogramma wilt bijwerken dat is geïnstalleerd op de standaardlocatie, gebruikt u de --global optie
Als u een algemeen hulpprogramma wilt bijwerken dat op een aangepaste locatie is geïnstalleerd, gebruikt u de --tool-path optie.
Als u een lokaal hulpprogramma wilt bijwerken, gebruikt u de --local optie.

Argumenten

PACKAGE_ID

Naam/id van het NuGet-pakket dat het globale .NET-hulpprogramma bevat dat moet worden bijgewerkt. U vindt de pakketnaam met behulp van de opdracht dotnet tool list .

Opties

--add-source <SOURCE>

Voegt een extra NuGet-pakketbron toe die tijdens de installatie moet worden gebruikt. Feeds worden parallel geopend, niet opeenvolgend in een bepaalde volgorde van prioriteit. Als hetzelfde pakket en dezelfde versie zich in meerdere feeds bevinden, wint de snelste feed. Zie Wat gebeurt er wanneer een NuGet-pakket is geïnstalleerd? voor meer informatie.

--all

Alle hulpprogramma's bijwerken.

--allow-downgrade

Een pakket downgrade toestaan bij het installeren of bijwerken van een .NET-hulpprogrammapakket. Onderdrukt de waarschuwing: 'De aangevraagde versie x.x.x is lager dan bestaande versie x.x.x.'.

--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

Voorkomen dat meerdere projecten parallel worden hersteld.
--framework <FRAMEWORK>

Hiermee geeft u het doelframework voor het bijwerken van het hulpprogramma voor.
-g|--global

Hiermee geeft u op dat de update voor een gebruikersbreed hulpprogramma is. Kan niet worden gecombineerd met de --tool-path optie. Het weglaten van beide --global en --tool-path geeft aan dat het hulpprogramma dat moet worden bijgewerkt een lokaal hulpprogramma is.

-?|-h|--help

Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

--ignore-failed-sources

Behandelt pakketbronfouten als waarschuwingen.

--interactive

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

--local

Werk het hulpprogramma en het lokale hulpprogrammamanifest bij. Kan niet worden gecombineerd met de --global optie of de --tool-path optie.
--no-cache

Sla geen pakketten en HTTP-aanvragen in de cache op.
--prerelease

Neem voorlopige versies op.
--tool-manifest <PATH>

Pad naar het manifestbestand.
--tool-path <PATH>

Hiermee geeft u de locatie op waar het globale hulpprogramma is geïnstalleerd. PATH kan absoluut of relatief zijn. Kan niet worden gecombineerd met de --global optie. Het weglaten van beide --global en --tool-path geeft aan dat het hulpprogramma dat moet worden bijgewerkt een lokaal hulpprogramma is.

-v|--verbosity <LEVEL>

Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. Zie LoggerVerbosity voor meer informatie.

--version <VERSION>

Het versiebereik van het hulpprogrammapakket dat moet worden bijgewerkt. Dit kan niet worden gebruikt om versies te downgraden. U moet eerst nieuwere versies gebruiken uninstall .

Vanaf .NET 8.0 --version Major.Minor.Patch verwijst u naar een specifieke major.minor.patch-versie, inclusief niet-vermelde versies. Als u in plaats daarvan de nieuwste versie van een bepaalde major.minor-versie wilt ophalen, gebruikt u --version Major.Minor.*.

Voorbeelden

dotnet tool update -g dotnetsay

Hiermee werkt u het globale hulpprogramma dotnetsay bij.
dotnet tool update dotnetsay --tool-path c:\global-tools

Hiermee werkt u het globale dotnetsay-hulpprogramma bij dat zich in een specifieke Windows-map bevindt.
dotnet tool update dotnetsay --tool-path ~/bin

Hiermee werkt u het globale dotnetsay-hulpprogramma bij dat zich in een specifieke Linux-/macOS-map bevindt.
dotnet tool update dotnetsay

Hiermee wordt het lokale dotnetsay-hulpprogramma bijgewerkt dat is geïnstalleerd voor de huidige map.
dotnet tool update -g dotnetsay --version 2.0.*

Werkt het algemene dotnetsay-hulpprogramma bij naar de nieuwste patchversie, met een primaire versie van 2en een secundaire versie van 0.
dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

Hiermee wordt het globale dotnetsay-hulpprogramma bijgewerkt naar de laagste versie binnen het opgegeven bereik (> 2.0.0 && < 2.1.4), wordt de versie 2.1.0 geïnstalleerd. Zie NuGet-pakketversiebereiken voor meer informatie over semantische versiebereiken.

Delen via