Delen via

dotnet-hulpmiddel installatie

Dit artikel is van toepassing op: ✔️ .NET 6 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] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

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

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--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.

Waarschuwing

Zorg ervoor dat de map die u opgeeft met de --tool-path optie veilig is. Hulpprogramma's die op deze locatie zijn geïnstalleerd, kunnen rechtstreeks worden uitgevoerd, dus het gebruik van een niet-vertrouwd of gedeeld pad kan beveiligingsrisico's veroorzaken.

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
Ramen %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. Vanaf .NET 10 wordt er automatisch een manifestbestand gemaakt als er nog geen manifestbestand bestaat. U kunt er ook handmatig een maken 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.

    Gebruik vanaf .NET 10.0.100 SDK de naam/id en versie, gescheiden door @ een .NET-hulpprogramma te installeren.

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

  • --allow-roll-forward

    Beschikbaar vanaf .NET 9.0 SDK. Sta het hulpprogramma toe om een nieuwere versie van de .NET-runtime te gebruiken als de runtime niet is geïnstalleerd.

  • -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. Als u deze optie gebruikt, gebruikt u de -r|--runtime optie niet. Beschikbaar sinds .NET 6 Preview 7.

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

    Beschikbaar vanaf .NET 8 SDK.

    Van toepassing op lokale hulpprogramma's. 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 (of, in .NET 10 en latere versies, indien niet opgegeven), 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.

    Vanaf .NET 10 wordt automatisch een manifest gemaakt als er geen hulpprogrammamanifest wordt gevonden. Deze wijziging kan een belangrijke wijziging zijn. U kunt zich afmelden door te geven --create-manifest-if-needed=false.

    Waarschuwing

    Voer geen hulpprogrammaopdrachten uit vanuit de map Downloads of een gedeelde locatie. De CLI begeleidt de mapstructuur om een hulpprogrammamanifest te vinden. Dit kan ertoe leiden dat het een manifest gebruikt dat u niet verwacht. Voer altijd hulpprogrammaopdrachten uit vanuit een vertrouwde, projectspecifieke map.

  • --disable-parallel

    Hiermee voorkomt u 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.

  • --source <SOURCE>

    Hiermee geeft u de bron voor NuGet-pakketten op.

  • -?|-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 of --no-http-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 voor het installeren van het globale hulpprogramma. 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], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. 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 --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 -g dotnetsay@2.1.7

    Installeert versie 2.1.7 van dotnetsay als een algemeen hulpprogramma.

  • dotnet tool install dotnetsay

    Installeert dotnetsay als een lokaal hulpprogramma voor de huidige map.

  • dotnet tool install dotnetsay@2.1.7

    Installeert versie 2.1.7 van dotnetsay als een lokaal hulpprogramma voor de huidige map.

  • dotnet tool install -g dotnetsay --verbosity minimal

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

  • dotnet tool install -g dotnetsay --allow-roll-forward

    Installeert dotnetsay als een globaal hulpprogramma en maakt het mogelijk om te worden uitgevoerd op nieuwere .NET-versies als de doelruntime niet beschikbaar is.

Zie ook

  • Last updated on