다음을 통해 공유


dotnet list package

이 문서는 .NET Core 3.1 SDK 이상 버전 ✔️ 적용됩니다.

이름

dotnet list package - 프로젝트 또는 솔루션에 대한 패키지 참조를 나열합니다.

개요

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

dotnet list package -h|--help

묘사

dotnet list package 명령은 특정 프로젝트 또는 솔루션에 대한 모든 NuGet 패키지 참조를 나열하는 편리한 옵션을 제공합니다. 먼저 이 명령을 처리하는 데 필요한 자산을 갖기 위해 프로젝트를 빌드해야 합니다. 다음 예제에서는 SentimentAnalysis 프로젝트에 대한 dotnet list package 명령의 출력을 보여줍니다.

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.

요청된 열은 프로젝트 파일에 지정된 패키지 버전을 참조하며 범위일 수 있습니다. 해결된 열에는 프로젝트가 현재 사용하고 있으며 항상 단일 값인 버전이 나열됩니다. 이름 바로 옆에 (A) 표시하는 패키지는 프로젝트 설정(Sdk 형식 또는 <TargetFramework> 또는 <TargetFrameworks> 속성)에서 유추되는 암시적 패키지 참조를 나타냅니다.

--outdated 옵션을 사용하여 프로젝트에서 사용 중인 패키지에 사용할 수 있는 최신 버전이 있는지 확인합니다. 기본적으로 확인된 버전이 시험판 버전이 아닌 한 --outdated 안정적인 최신 패키지를 나열합니다. 최신 버전을 나열할 때 시험판 버전을 포함하려면 --include-prerelease 옵션도 지정합니다. 패키지를 최신 버전으로 업데이트하려면 dotnet add package사용합니다.

다음 예제에서는 이전 예제와 동일한 프로젝트에 대한 dotnet list package --outdated --include-prerelease 명령의 출력을 보여줍니다.

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

프로젝트에 전이적 종속성이 있는지 확인해야 하는 경우 --include-transitive 옵션을 사용합니다. 전이적 종속성은 다른 패키지에 의존하는 패키지를 프로젝트에 추가할 때 발생합니다. 다음 예제에서는 최상위 패키지와 해당 패키지가 의존하는 패키지를 표시하는 HelloPlugin 프로젝트에 대한 dotnet list package --include-transitive 명령을 실행한 출력을 보여 줍니다.

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

인수

PROJECT | SOLUTION

작업할 프로젝트 또는 솔루션 파일입니다. 지정하지 않으면 명령은 현재 디렉터리를 검색합니다. 둘 이상의 솔루션 또는 프로젝트가 발견되면 오류가 throw됩니다.

옵션

  • --config <SOURCE>

    최신 패키지를 검색할 때 사용할 NuGet 원본입니다. --outdated 옵션이 필요합니다.

  • --deprecated

    사용되지 않는 패키지를 표시합니다.

  • -f|--framework <FRAMEWORK>

    지정된 대상 프레임워크적용할 수 있는 패키지만 표시합니다. 여러 프레임워크를 지정하려면 이 옵션을 여러 번 반복합니다. 예: --framework net6.0 --framework netstandard2.0. 옵션(-f)의 짧은 형식은 .NET 9 SDK부터 사용할 수 있습니다.

  • -?|-h|--help

    명령을 사용하는 방법에 대한 설명을 출력합니다.

  • --highest-minor

    최신 패키지를 검색할 때 주 버전 번호가 일치하는 패키지만 고려합니다. --outdated 또는 --deprecated 옵션이 필요합니다.

  • --highest-patch

    최신 패키지를 검색할 때 주 및 부 버전 번호가 일치하는 패키지만 고려합니다. --outdated 또는 --deprecated 옵션이 필요합니다.

  • --include-prerelease

    최신 패키지를 검색할 때 시험판 버전이 있는 패키지를 고려합니다. --outdated 또는 --deprecated 옵션이 필요합니다.

  • --include-transitive

    최상위 패키지 외에도 전이적 패키지를 나열합니다. 이 옵션을 지정할 때 최상위 패키지가 의존하는 패키지 목록을 가져옵니다.

  • --interactive

    명령을 중지하고 사용자 입력 또는 작업을 기다릴 수 있습니다. 예를 들어 인증을 완료합니다. .NET Core 3.0 SDK부터 사용할 수 있습니다.

  • --outdated

    사용 가능한 최신 버전이 있는 패키지를 나열합니다.

  • -s|--source <SOURCE>

    최신 패키지를 검색할 때 사용할 NuGet 원본입니다. --outdated 또는 --deprecated 옵션이 필요합니다.

  • -v|--verbosity <LEVEL>

    명령의 세부 정보 수준을 설정합니다. 허용되는 값은 q[uiet], m[inimal], n[ormal], d[etailed]diag[nostic]. 기본값은 minimal. 자세한 내용은 LoggerVerbosity참조하세요.

  • --vulnerable

    알려진 취약성이 있는 패키지를 나열합니다. --deprecated 또는 --outdated 옵션과 결합할 수 없습니다. 구성 파일의 <AuditSources> 속성을 사용하여 VulnerabilityInfo 리소스에서 얻은 취약성 데이터의 원본을 지정합니다. <AuditSources> 지정하지 않으면 지정된 <PackageSources> 취약성 데이터를 로드하는 데 사용됩니다. 자세한 내용은 감사 원본NuGet 패키지에서 보안 취약성검사하는 방법을 참조하세요.

  • --format <console|json>

    보고서 출력 형식을 설정합니다. 허용되는 값은 console, json. 기본값은 console. .NET SDK 7.0.200부터 사용할 수 있습니다.

  • --output-version <VERSION>

    보고서 출력 버전을 설정합니다. 허용되는 값은 1. 기본값은 1. --format json 옵션이 필요합니다. 새 JSON 버전을 사용할 수 있는 경우 명령은 기본적으로 새 형식을 생성합니다. 이 옵션을 사용하면 명령에서 이전 형식을 생성하도록 지정할 수 있습니다. .NET SDK 7.0.200부터 사용할 수 있습니다.

예제

  • 특정 프로젝트의 패키지 참조를 나열합니다.

    dotnet list SentimentAnalysis.csproj package
    
  • 시험판 버전을 포함하여 최신 버전을 사용할 수 있는 패키지 참조를 나열합니다.

    dotnet list package --outdated --include-prerelease
    
  • 특정 대상 프레임워크에 대한 패키지 참조를 나열합니다.

    dotnet list package --framework netcoreapp3.0
    
  • 컴퓨터에서 읽을 수 있는 json 출력 형식으로 패키지 참조를 나열합니다.

    dotnet list package --format json
    
  • 컴퓨터에서 읽을 수 있는 json 출력 형식으로 특정 대상 프레임워크에 대한 패키지 참조를 나열합니다.

    dotnet list package --framework netcoreapp3.0 --format json
    
  • 전이적 종속성 및 취약성 세부 정보를 포함하여 패키지 참조의 머신 읽기 가능한 json 출력을 파일에 저장합니다.

    dotnet list package --include-transitive --vulnerable --format json >> dependencyReport.json
    
  • 출력 버전 1을 사용하여 컴퓨터에서 읽을 수 있는 json 출력 형식으로 패키지 참조를 나열합니다.

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