Delen via

dotnet tool install

  • Artikel

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

Naam

dotnet tool install - Installeert het opgegeven .NET-hulpprogramma op uw computer.

Samenvatting

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Beschrijving

Met de dotnet tool install opdracht kunt u .NET-hulpprogramma's op uw computer installeren. Als u de opdracht wilt gebruiken, geeft u een van de volgende installatieopties op:

  • Als u een globaal hulpprogramma op de standaardlocatie wilt installeren, gebruikt u de --global optie.
  • Als u een globaal hulpprogramma op een aangepaste locatie wilt installeren, gebruikt u de --tool-path optie.
  • Als u een lokaal hulpprogramma wilt installeren, laat u de --global en --tool-path opties weg.

Installatielocaties

Algemene hulpprogramma's

Globale hulpprogramma's worden standaard geïnstalleerd in de volgende mappen wanneer u de -g of --global optie opgeeft:

Besturingssysteem Pad
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Uitvoerbare bestanden worden gegenereerd in deze mappen voor elk globaal geïnstalleerd hulpprogramma, hoewel de werkelijke binaire bestanden van het hulpprogramma diep in de map op hetzelfde niveau .store zijn genest.

Notitie

Op Linux na het installeren van een opdrachtregelprogramma met dotnet tool, kan het hulpprogramma alleen vanuit het $HOME/.dotnet/tools pad worden uitgevoerd. Werk de PATH omgevingsvariabele bij om het hulpprogramma uitvoerbaar te maken vanuit een map. Werk de shell-instellingen bij om de bijgewerkte omgevingsvariabele PATH permanent te maken in uw shell. Dit Bashis het $HOME/.bashrc bestand.

--tool-path gereedschap

Hulpprogramma's met expliciete hulpprogrammapaden worden opgeslagen waar u de --tool-path parameter hebt opgegeven waarnaar moet worden aangegeven. Ze worden op dezelfde manier opgeslagen als globale hulpprogramma's: een uitvoerbaar binair met de werkelijke binaire bestanden in een map op hetzelfde niveau .store .

Lokale hulpprogramma's

Lokale hulpprogramma's worden opgeslagen in de globale NuGet-map, wat u ook hebt ingesteld. Er zijn shim-bestanden voor $HOME/.dotnet/toolResolverCache elk lokaal hulpprogramma dat verwijst naar de locatie waar de hulpprogramma's zich bevinden.

Verwijzingen naar lokale hulpprogramma's worden toegevoegd aan een dotnet-tools.json-bestand in een .config-map onder de huidige map. Als er nog geen manifestbestand bestaat, maakt u het met behulp van de --create-manifest-if-needed optie of door de volgende opdracht uit te voeren:

dotnet new tool-manifest

Zie Een lokaal hulpprogramma installeren voor meer informatie.

Argumenten

  • PACKAGE_NAME

    Naam/id van het NuGet-pakket dat het .NET-hulpprogramma bevat dat moet worden geïnstalleerd.

Opties

  • --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.'.

  • -a|--arch <ARCHITECTURE>

    Hiermee geeft u de doelarchitectuur. Dit is een verkorte syntaxis voor het instellen van de Runtime-id (RID), waarbij de opgegeven waarde wordt gecombineerd met de standaard-RID. Als u bijvoorbeeld op een win-x64 computer opgeeft --arch x86 , wordt de RID ingesteld op win-x86.

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

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

  • --create-manifest-if-needed

    Van toepassing op lokale hulpprogramma's. Beschikbaar vanaf .NET 8 SDK. Om een manifest te vinden, zoekt het zoekalgoritmen de mapstructuur naar dotnet-tools.json of een .config map die een dotnet-tools.json bestand bevat.

    Als een hulpprogrammamanifest niet kan worden gevonden en de --create-manifest-if-needed optie is ingesteld op false, treedt de CannotFindAManifestFile fout op.

    Als een hulpprogrammamanifest niet kan worden gevonden en de --create-manifest-if-needed optie is ingesteld op true, wordt er automatisch een manifest gemaakt. Er wordt als volgt een map voor het manifest gekozen:

    • Loop de mapstructuur door naar een map met een .git submap te zoeken. Als er een is gevonden, maakt u het manifest in die map.
    • Als in de vorige stap geen map wordt gevonden, gaat u naar de mapstructuur die zoekt naar een map met een .sln of .git meer bestanden. Als er een is gevonden, maakt u het manifest in die map.
    • Als geen van de vorige twee stappen een map vindt, maakt u het manifest in de huidige werkmap.

    Zie Een lokaal hulpprogramma installeren voor meer informatie over de locatie van manifesten.

  • --disable-parallel

    Voorkomen dat meerdere projecten parallel worden hersteld.

  • --framework <FRAMEWORK>

    Hiermee geeft u het doelframework op waarvoor het hulpprogramma moet worden geïnstalleerd. De .NET SDK probeert standaard het meest geschikte doelframework te kiezen.

  • -g|--global

    Hiermee geeft u op dat de installatie gebruikersbreed is. Kan niet worden gecombineerd met de --tool-path optie. U kunt beide --global weglaten en --tool-path een lokale installatie van het hulpprogramma opgegeven.

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

    Cachepakketten en HTTP-aanvragen niet.

  • --prerelease

    Neem voorlopige pakketten op.

  • --tool-manifest <PATH>

    Pad naar het manifestbestand.

  • --tool-path <PATH>

    Hiermee geeft u de locatie op waar het globale hulpprogramma moet worden geïnstalleerd. PATH kan absoluut of relatief zijn. Als PATH niet bestaat, probeert de opdracht deze te maken. U kunt beide --global weglaten en --tool-path een lokale installatie van het hulpprogramma opgegeven.

  • -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]. Zie LoggerVerbosity voor meer informatie.

  • --version <VERSION_NUMBER>

    De versie van het hulpprogramma dat moet worden geïnstalleerd. Standaard wordt de meest recente stabiele pakketversie geïnstalleerd. Gebruik deze optie om preview- of oudere versies van het hulpprogramma te installeren.

    Vanaf .NET 8.0 --version Major.Minor.Patch verwijst u naar een specifieke primaire/secundaire/patchversie, inclusief niet-vermelde versies. Gebruik --version Major.Minor.*in plaats daarvan de nieuwste versie van een bepaalde primaire/secundaire versie.

Voorbeelden

  • dotnet tool install -g dotnetsay

    Installeert dotnetsay als een globaal hulpprogramma op de standaardlocatie.

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

    Installeert dotnetsay als een globaal hulpprogramma in een specifieke Windows-map.

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

    Hiermee installeert u dotnetsay als een globaal hulpprogramma in een specifieke Linux-/macOS-map.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Installeert versie 2.0.0 van dotnetsay als een algemeen hulpprogramma.

  • dotnet tool install dotnetsay

    Installeert dotnetsay als een lokaal hulpprogramma voor de huidige map.

  • dotnet tool install -g --verbosity minimal

    Installeert dotnetsay als een globaal hulpprogramma met de uitgebreidheid van minimaal. De standaard uitgebreidheid voor globale hulpprogramma's is stil.

Zie ook