dotnet tool update
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>] [--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>] [--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>] [--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.
--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 het gebruik van de opdracht.
--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 zijn
q[uiet]
, , ,n[ormal]
endiag[nostic]
d[etailed]
m[inimal]
. 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
2
en een secundaire versie van0
.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 versie2.1.0
geïnstalleerd. Zie NuGet-pakketversiebereiken voor meer informatie over semantische versiebereiken.