Delen via

dotnet-pakketlijst

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

Naam

dotnet package list : geeft de pakketverwijzingen voor een project of oplossing weer.

Notitie

Als u .NET 9 SDK of eerder gebruikt, gebruikt u in plaats daarvan het formulier 'werkwoord eerst' (dotnet list package). Het zelfstandig naamwoordformulier is geïntroduceerd in .NET 10. Zie Meer consistente opdrachtvolgorde voor meer informatie.

Samenvatting

dotnet package list [--config <SOURCE>]
    [--deprecated] [--project [<PROJECT>|<SOLUTION>]]
    [-f|--framework <FRAMEWORK>] [--highest-minor] [--highest-patch]
    [--include-prerelease] [--include-transitive] [--interactive]
    [--no-restore] [--outdated] [--source <SOURCE>] [-v|--verbosity <LEVEL>]
    [--vulnerable]
    [--format <console|json>]
    [--output-version <VERSION>]

dotnet package list -h|--help

Beschrijving

De opdracht dotnet package list biedt een handige optie om alle NuGet-pakketverwijzingen voor een specifiek project of een oplossing weer te geven. Vanaf .NET 10 wordt met de opdracht automatisch herstel uitgevoerd voordat de resultaten worden gegenereerd. In eerdere versies moet u eerst het project bouwen/herstellen om de assets te hebben die nodig zijn om deze opdracht te kunnen verwerken. In het volgende voorbeeld ziet u de uitvoer van de opdracht dotnet package list voor het SentimentAnalysis project:

Restore complete (5.9s)

Build succeeded in 6.0s
Project 'SentimentAnalysis' has the following package references
   [netcoreapp2.1]:
   Top-level Package               Requested   Resolved
   > Microsoft.ML                  1.4.0       1.4.0
   > Microsoft.NETCore.App   (A)   [2.1.0, )   2.1.0

(A) : Auto-referenced package.

De kolom Aangevraagde verwijst naar de pakketversie die is opgegeven in het projectbestand en kan een bereik zijn. De kolom Opgeloste bevat de versie die het project momenteel gebruikt en is altijd één waarde. De pakketten die een (A) naast hun namen weergeven, vertegenwoordigen impliciete pakketverwijzingen die zijn afgeleid van uw projectinstellingen (Sdk type of <TargetFramework> of <TargetFrameworks> eigenschap).

Als u de automatische herstelbewerking wilt overslaan, kunt u de --no-restore optie gebruiken. Voorbeeld dotnet package list --no-restore:

Project 'SentimentAnalysis' has the following package references
   [netcoreapp2.1]:
   Top-level Package               Requested   Resolved
   > Microsoft.ML                  1.4.0       1.4.0
   > Microsoft.NETCore.App   (A)   [2.1.0, )   2.1.0

(A) : Auto-referenced package.

Gebruik de optie --outdated om erachter te komen of er nieuwere versies beschikbaar zijn van de pakketten die u in uw projecten gebruikt. Standaard geeft --outdated de meest recente stabiele pakketten weer, tenzij de opgeloste versie ook een voorlopige versie is. Als u voorlopige versies wilt opnemen bij het weergeven van nieuwere versies, geeft u ook de optie --include-prerelease op. Als u een pakket wilt bijwerken naar de nieuwste versie, gebruikt u dotnet-pakket toevoegen.

In het volgende voorbeeld ziet u de uitvoer van de opdracht dotnet package list --outdated --include-prerelease voor hetzelfde project als in het vorige voorbeeld:

Restore complete (0.6s)

Build succeeded in 0.7s

The following sources were used:
   https://api.nuget.org/v3/index.json
   C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\

Project `SentimentAnalysis` has the following updates to its packages
   [netcoreapp2.1]:
   Top-level Package      Requested   Resolved   Latest
   > Microsoft.ML         1.4.0       1.4.0      1.5.0-preview

Als u wilt weten of uw project transitieve afhankelijkheden heeft, gebruikt u de optie --include-transitive. Transitieve afhankelijkheden treden op wanneer u een pakket toevoegt aan uw project dat op zijn beurt afhankelijk is van een ander pakket. In het volgende voorbeeld ziet u de uitvoer van het uitvoeren van de opdracht dotnet package list --include-transitive voor het project HelloPlugin, waarin pakketten op het hoogste niveau en de pakketten worden weergegeven waarvan ze afhankelijk zijn:

Restore complete (0.6s)

Build succeeded in 0.7s
Project 'HelloPlugin' has the following package references
   [netcoreapp3.0]:
   Transitive Package      Resolved
   > PluginBase            1.0.0

Argumenten

PROJECT | SOLUTION

Het project- of oplossingsbestand waarop moet worden gewerkt. Als dit niet is opgegeven, zoekt de opdracht in de huidige map naar een map. Als er meer dan één oplossing of project wordt gevonden, wordt er een fout gegenereerd.

Opties

  • --config <SOURCE>

    De NuGet-bronnen die moeten worden gebruikt bij het zoeken naar nieuwere pakketten. Hiervoor is de optie --outdated vereist.

  • --deprecated

    Geeft pakketten weer die zijn afgeschaft.

  • -f|--framework <FRAMEWORK>

    Geeft alleen de pakketten weer die van toepassing zijn op het opgegeven doelframework. Als u meerdere frameworks wilt opgeven, herhaalt u de optie meerdere keren. Voorbeeld: --framework net6.0 --framework netstandard2.0. De korte vorm van de optie (-f) is beschikbaar vanaf .NET 9 SDK.

  • -?|-h|--help

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

  • --highest-minor

    Houdt alleen rekening met de pakketten met een overeenkomend versienummer bij het zoeken naar nieuwere pakketten. Hiervoor is de optie --outdated of --deprecated vereist.

  • --highest-patch

    Houdt alleen rekening met de pakketten met een overeenkomende primaire en secundaire versienummers bij het zoeken naar nieuwere pakketten. Hiervoor is de optie --outdated of --deprecated vereist.

  • --include-prerelease

    Houdt rekening met pakketten met voorlopige versies bij het zoeken naar nieuwere pakketten. Hiervoor is de optie --outdated of --deprecated vereist.

  • --include-transitive

    Bevat transitieve pakketten, naast de pakketten op het hoogste niveau. Wanneer u deze optie opgeeft, krijgt u een lijst met pakketten waarvan de pakketten op het hoogste niveau afhankelijk zijn.

  • --interactive

    Hiermee kan de opdracht stoppen en wachten op invoer of actie van de gebruiker. Bijvoorbeeld om de verificatie te voltooien. Beschikbaar sinds .NET Core 3.0 SDK.

  • --no-restore

    Herstel niet voordat u de opdracht uitvoert.

  • --outdated

    Bevat pakketten met nieuwere versies.

  • -s|--source <SOURCE>

    De NuGet-bronnen die moeten worden gebruikt bij het zoeken naar nieuwere pakketten. Hiervoor is de optie --outdated of --deprecated vereist.

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

  • --vulnerable

    Bevat pakketten met bekende beveiligingsproblemen. Kan niet worden gecombineerd met --deprecated of --outdated opties. Deze optie is beschikbaar vanaf .NET SDK 9.0.300. Deze optie gebruikt de <AuditSources> eigenschap in uw configuratiebestand om uw bron van beveiligingsgegevens op te geven, die wordt verkregen uit de resource VulnerabilityInfo . Als <AuditSources> niet is opgegeven, worden de opgegeven <PackageSources> gebruikt om gegevens over beveiligingsproblemen te laden. Zie Bronnen controleren en NuGet-pakketten scannen op beveiligingsproblemenvoor meer informatie.

  • --format <console|json>

    Hiermee stelt u de indeling van de rapportuitvoer in. Toegestane waarden zijn console, json. Standaard ingesteld op console. Beschikbaar vanaf .NET SDK 7.0.200.

  • --output-version <VERSION>

    Hiermee stelt u de uitvoerversie van het rapport in. Toegestane waarde is 1. Standaard ingesteld op 1. Hiervoor is de optie --format json vereist. Wanneer er een nieuwe JSON-versie beschikbaar is, produceert de opdracht standaard de nieuwe indeling. Met deze optie kunt u opgeven dat de opdracht een eerdere indeling moet produceren. Beschikbaar vanaf .NET SDK 7.0.200.

Voorbeelden

  • Pakketverwijzingen van een specifiek project weergeven:

    dotnet package list --project SentimentAnalysis.csproj

  • Lijst met pakketverwijzingen met nieuwere versies, waaronder voorlopige versies:

    dotnet package list --outdated --include-prerelease

  • Lijst met pakketverwijzingen voor een specifiek doelframework:

    dotnet package list --framework netcoreapp3.0

  • Lijst met pakketverwijzingen in de leesbare JSON-uitvoerindeling van de machine:

    dotnet package list --format json

  • Lijst met pakketverwijzingen voor een specifiek doelframework in de leesbare JSON-uitvoerindeling van de machine:

    dotnet package list --framework netcoreapp3.0 --format json

  • Sla de leesbare JSON-uitvoer van pakketverwijzingen op, inclusief transitieve afhankelijkheid en details van beveiligingsproblemen in een bestand:

    dotnet package list --include-transitive --vulnerable --format json >> dependencyReport.json

  • Lijst met pakketverwijzingen in de leesbare JSON-uitvoerindeling met uitvoerversie 1:

    dotnet package list --format json --output-version 1