Delen via

dotnet tool exec

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

Naam

dotnet tool exec - Downloadt en roept een .NET-hulpprogramma aan zonder het permanent te installeren.

Samenvatting

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

De dotnet tool exec opdracht biedt een eenmalige aanroepmodus voor hulpprogramma's voor .NET Tools. Het opgegeven hulpprogrammapakket wordt automatisch gedownload naar de NuGet-cache en wordt aangeroepen zonder uw systeem PATH te wijzigen of permanente installatie te vereisen.

Wanneer u deze uitvoert dotnet tool exec, voert u de volgende opdracht uit:

  1. Controleert de versie (of versiebereik) die u opgeeft (of de nieuwste versie als er geen is opgegeven) op basis van uw geconfigureerde NuGet-feeds om te bepalen welk pakket moet worden gedownload.
  2. Hiermee wordt het opgegeven pakket gedownload naar de NuGet-cache (indien nog niet aanwezig).
  3. Roept het hulpprogramma aan met eventuele opgegeven argumenten.
  4. Retourneert de afsluitcode van het hulpprogramma.

dotnet tool exec werkt naadloos samen met zowel globale als lokale hulpprogramma's. Als er een lokaal hulpprogrammamanifest beschikbaar is, wordt het manifest gebruikt om te bepalen welke versie van het hulpprogramma moet worden uitgevoerd.

Deze opdracht bestaat ook in twee andere formulieren voor eenvoudiger gebruik

  • dotnet dnx - Een verborgen alias voor dotnet tool exec die wordt gebruikt als een manier om eenvoudig het dnx script zelf te implementeren
  • dnx - Een shellscript dat wordt aangeroepen dotnet dnx vanuit de SDK. Dit script wordt geleverd door het installatieprogramma en is beschikbaar op PATH. Het maakt zeer eenvoudig gebruik van hulpprogramma's rechtstreeks via dnx <toolname>.

Arguments

  • PACKAGE_NAME

    De NuGet-pakket-id van het .NET-hulpprogramma dat moet worden uitgevoerd. U kunt desgewenst een versie opgeven met behulp van de @ syntaxis, bijvoorbeeld dotnetsay@2.1.0.

  • tool-arguments

    Argumenten die moeten worden doorgegeven aan het hulpprogramma dat wordt uitgevoerd. Alles na -- is rechtstreeks doorgegeven aan het hulpprogramma.

Options

  • --allow-roll-forward

    Hiermee staat u toe dat het hulpprogramma een nieuwere versie van de .NET-runtime gebruikt als de runtime niet is geïnstalleerd.

  • --add-source <SOURCE>

    Voegt een extra NuGet-pakketbron toe die tijdens de installatie moet worden gebruikt. Feeds worden parallel geopend, niet in een trapsgewijze terugvalreeks. Als hetzelfde pakket en dezelfde versie beschikbaar zijn in meerdere feeds, wint de snelste feed. Zie Wat gebeurt er wanneer een NuGet-pakket is geïnstalleerd voor meer informatie. U kunt dit beheren via het gebruik van NuGet-pakketbrontoewijzing. Zie Pakketbrontoewijzing 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.

  • --disable-parallel

    Hiermee voorkomt u dat meerdere projecten parallel worden hersteld.

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

  • --no-http-cache

    Http-aanvragen worden niet in de cache opgeslagen in de geconfigureerde NuGet-feeds.

  • --prerelease

    Hiermee kunnen prereleasepakketten worden geselecteerd bij het omzetten van de versie die moet worden geïnstalleerd.

  • --source <SOURCE>

    Hiermee geeft u de bron voor NuGet-pakketten op.

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

  • -?|-h|--help

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

Voorbeelden

  • dotnet tool exec dotnetsay

    Downloadt (indien nodig) en voert de nieuwste versie van het dotnetsay hulpprogramma uit.

  • dotnet tool exec dotnetsay@2.1.0

    Downloadt (indien nodig) en voert versie 2.1.0 van het dotnetsay hulpprogramma uit.

  • dotnet tool exec dotnetsay@2.*

    Downloadt (indien nodig) en voert de nieuwste versie van het dotnetsay hulpprogramma uit in het versiebereik 2.x.

  • dotnet tool exec dotnetsay -- Hello World

    dotnetsay Het hulpprogramma wordt uitgevoerd en 'Hallo wereld' als argumenten doorgegeven aan het hulpprogramma.

  • dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

    Downloads en uitvoeringen mytool met behulp van de opgegeven NuGet-bron.

Vergelijking met andere opdrachten

Deze opdracht is bedoeld als een uniforme manier om te werken met .NET Tools. Hoewel de eerder beschikbare hulpprogramma-installatieopdrachten beschikbaar blijven, dotnet tool exec biedt een eenvoudigere en flexibelere ervaring voor de meeste gebruikers.

Command Purpose Installatie Scope
dotnet tool exec Uitvoering met één shot Geen (alleen in cache opgeslagen) Temporary
dotnet tool install -g Permanente globale installatie Global Systeembrede
dotnet tool install Permanente lokale installatie Lokaal manifest Project
dotnet tool run Een al geïnstalleerd lokaal hulpprogramma uitvoeren Vereist eerdere installatie Project

De dotnet tool install -g opdracht biedt nog steeds een belangrijk doel voor gebruikers die een hulpprogramma permanent willen installeren. Gebruikers die een hulpprogramma willen uitproberen of uitvoeren in een CI/CD-pijplijn, dotnet tool exec zijn echter vaak beter geschikt.

Zie ook

  • Last updated on