Dela via


uppdatering av dotnet-verktyget

Den här artikeln gäller för: ✔️ .NET 6 SDK och senare versioner

Namn

dotnet tool update – Uppdaterar det angivna .NET-verktyget på datorn.

Sammanfattning

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

Beskrivning

Kommandot dotnet tool update ger dig ett sätt att uppdatera .NET-verktyg på datorn till den senaste stabila versionen av paketet. Kommandot avinstallerar och installerar om ett verktyg och uppdaterar det effektivt. Om du vill använda kommandot anger du något av följande alternativ:

  • Om du vill uppdatera ett globalt verktyg som installerades på standardplatsen använder du --global alternativet
  • Om du vill uppdatera ett globalt verktyg som har installerats på en anpassad plats använder du alternativet --tool-path .
  • Om du vill uppdatera ett lokalt verktyg använder du alternativet --local .

Argumentpunkter

  • PACKAGE_ID

    Namn/ID för NuGet-paketet som innehåller det globala .NET-verktyget som ska uppdateras. Du hittar paketnamnet med hjälp av kommandot dotnet tool list .

Alternativ

  • --add-source <SOURCE>

    Lägger till ytterligare en NuGet-paketkälla som ska användas under installationen. Feeds nås parallellt, inte sekventiellt i någon prioritetsordning. Om samma paket och version finns i flera feeds vinner den snabbaste feeden. Mer information finns i Vad händer när ett NuGet-paket installeras?.

  • --all

    Uppdatera alla verktyg.

  • --allow-downgrade

    Tillåt nedgradering av paket när du installerar eller uppdaterar ett .NET-verktygspaket. Undertrycker varningen: "Den begärda versionen x.x.x är lägre än den befintliga versionen x.x.x."

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • --disable-parallel

    Förhindra att flera projekt återställs parallellt.

  • --framework <FRAMEWORK>

    Anger det målramverk som verktyget ska uppdateras för.

  • -g|--global

    Anger att uppdateringen är för ett användaromfattande verktyg. Det går inte att kombinera med alternativet --tool-path . Om du utelämnar båda --global och --tool-path anger att verktyget som ska uppdateras är ett lokalt verktyg.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • --ignore-failed-sources

    Behandla paketkällans fel som varningar.

  • --interactive

    Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen.

  • --local

    Uppdatera verktyget och det lokala verktygsmanifestet. Det går inte att kombinera med --global alternativet eller alternativet --tool-path .

  • --no-cache

    Cachelagrade inte paket och HTTP-begäranden.

  • --prerelease

    Inkludera förhandsversioner.

  • --tool-manifest <PATH>

    Sökväg till manifestfilen.

  • --tool-path <PATH>

    Anger platsen där det globala verktyget är installerat. PATH kan vara absolut eller relativ. Det går inte att kombinera med alternativet --global . Om du utelämnar båda --global och --tool-path anger att verktyget som ska uppdateras är ett lokalt verktyg.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Mer information finns i LoggerVerbosity.

  • --version <VERSION>

    Versionsintervallet för verktygspaketet som ska uppdateras till. Detta kan inte användas för att nedgradera versioner. Du måste uninstall först ha nyare versioner.

    Från och med .NET 8.0 --version Major.Minor.Patch refererar till en specifik major.minor.patch-version, inklusive olistade versioner. Om du vill hämta den senaste versionen av en viss major.minor-version i stället använder du --version Major.Minor.*.

Exempel

  • dotnet tool update -g dotnetsay

    Uppdaterar det globala dotnetsay-verktyget .

  • dotnet tool update dotnetsay --tool-path c:\global-tools

    Uppdaterar det globala dotnetsay-verktyget som finns i en specifik Windows-katalog.

  • dotnet tool update dotnetsay --tool-path ~/bin

    Uppdaterar det globala dotnetsay-verktyget som finns i en specifik Linux/macOS-katalog.

  • dotnet tool update dotnetsay

    Uppdaterar det lokala dotnetsay-verktyget som är installerat för den aktuella katalogen.

  • dotnet tool update -g dotnetsay --version 2.0.*

    Uppdaterar det globala dotnetsay-verktyget till den senaste korrigeringsversionen med en större version av 2och en delversion av 0.

  • dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

    Uppdaterar det globala dotnetsay-verktyget till den lägsta versionen inom det angivna intervallet (> 2.0.0 && < 2.1.4), versionen 2.1.0 skulle installeras. Mer information om semantiska versionsintervall finns i NuGet-paketeringsversionsintervall.

Se även