dotnet tool exec

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

Namn

dotnet tool exec – Laddar ned och anropar ett .NET-verktyg utan att installera det permanent.

Sammanfattning

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]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

Kommandot dotnet tool exec tillhandahåller ett anropsläge för ett enda skott för .NET Tools. Det laddar automatiskt ned det angivna verktygspaketet till NuGet-cachen och anropar det utan att ändra systemet PATH eller kräva permanent installation.

När du kör dotnet tool exec, kommandot:

1. Kontrollerar vilken version (eller versionsintervall) du anger (eller den senaste versionen om ingen har angetts) mot dina konfigurerade NuGet-feeds för att bestämma vilket paket som ska laddas ned.
2. Laddar ned det angivna paketet till NuGet-cachen (om det inte redan finns).
3. Anropar verktyget med alla angivna argument.
4. Returnerar verktygets slutkod.

dotnet tool exec fungerar sömlöst med både globala och lokala verktyg. Om du har ett lokalt verktygsmanifest tillgängligt används manifestet för att avgöra vilken version av verktyget som ska köras.

Det här kommandot finns också i två andra formulär för enklare användning

• dotnet dnx– Ett dolt alias för dotnet tool exec som används som ett sätt att enkelt implementera själva skriptet dnx
• dnx – Ett gränssnittsskript som anropar dotnet dnx från SDK:et. Det här skriptet tillhandahålls av installationsprogrammet och är tillgängligt på PATH. Det möjliggör mycket enkel användning av verktyg direkt via dnx <toolname>.

Arguments

• PACKAGE_NAME

  NuGet-paket-ID för .NET-verktyget som ska köras. Du kan också ange en version med hjälp av syntaxen @ , till exempel dotnetsay@2.1.0.

• tool-arguments

  Argument som ska skickas till verktyget som körs. Allt efter -- skickas direkt till verktyget.

Options

• --allow-roll-forward

  Tillåt att verktyget använder en nyare version av .NET-körningen om den körning som den riktar sig mot inte är installerad.

• --add-source <SOURCE>

  Lägger till ytterligare en NuGet-paketkälla som ska användas under installationen. Feeds nås parallellt, inte i en reservkaskadsekvens. Om samma paket och version är tillgängliga i flera feeds vinner den snabbaste feeden. Mer information finns i Vad händer när ett NuGet-paket installeras. Du kan styra detta med hjälp av NuGet-paketkällmappning. Mer information finns i Mappning av paketkälla.

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

  Inaktiverar parallella frågor mot konfigurerade NuGet-feeds.

• --ignore-failed-sources

  Behandlar paketkällans fel som varningar.

• --interactive

  Tillåter att kommandot stoppar och väntar på användarindata eller åtgärd, till exempel för att slutföra autentiseringen. Det här alternativet används true som standard när kommandot identifierar att det körs direkt av en användare.

• --no-http-cache

  Cachelagrar inte HTTP-begäranden till konfigurerade NuGet-feeds.

• --prerelease

  Tillåter att förhandsversionspaket väljs när du löser den version som ska installeras.

• -v|--verbosity <LEVEL>

  Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är normal.

• -?|-h|--help

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

Examples

• dotnet tool exec dotnetsay

  Laddar ned (om det behövs) och kör den senaste versionen av dotnetsay verktyget.

• dotnet tool exec dotnetsay@2.1.0

  Laddar ned (om det behövs) och kör version 2.1.0 av dotnetsay verktyget.

• dotnet tool exec dotnetsay@2.*

  Laddar ned (om det behövs) och kör den senaste versionen av dotnetsay verktyget i 2.x-versionsintervallet.

• dotnet tool exec dotnetsay -- Hello World

  dotnetsay Kör verktyget och skickar "Hello World" som argument till verktyget.

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

  Laddar ned och kör mytool med den angivna NuGet-källan.

Jämförelse med andra kommandon

Det här kommandot är avsett att vara ett enhetligt sätt att arbeta med .NET Tools. Även om de tidigare tillgängliga verktygsinstallationskommandona fortfarande är tillgängliga ger dotnet tool exec det en enklare och mer flexibel upplevelse för de flesta användare.

Kommandot dotnet tool install -g har fortfarande ett viktigt syfte för användare som vill installera ett verktyg permanent. Men för användare som vill prova ett verktyg eller köra det i en CI/CD-pipeline dotnet tool exec passar det ofta bättre.

Se även

• .NET-verktyg
• installation av dotnet-verktyget
• dotnet-verktygskörning
• Självstudie: Installera och använda ett globalt .NET-verktyg med hjälp av .NET CLI
• Självstudie: Installera och använda ett lokalt .NET-verktyg med hjälp av .NET CLI