NuGet CLI 참조
NUGet CLI(명령줄 인터페이스) nuget.exe는 프로젝트 파일을 변경하지 않고 패키지를 설치, 만들기, 게시 및 관리하는 NuGet 기능의 전체 범위를 제공합니다.
명령을 사용하려면 명령 창 또는 bash 셸을 연 다음 명령과 적절한 옵션(예: nuget help pack pack 명령에 대한 도움말 보기)을 실행 nuget 합니다.
이 설명서는 최신 버전의 NuGet CLI를 반영합니다. 사용 중인 지정된 버전에 대한 정확한 세부 정보를 보려면 원하는 명령을 실행 nuget help 합니다.
nuget.exe CLI에서 기본 명령을 사용하는 방법에 대한 자세한 내용은 nuget.exe CLI를 사용하여 패키지 설치 및 사용을 참조하세요.
nuget.exe 설치
항상 구성을 지원하는 최신 버전의 도구를 설치합니다.
- 에서 최신 권장 버전을
https://dist.nuget.org/win-x86-commandline/latest/nuget.exe다운로드할 수 있습니다. - CLI 도구가
nuget.exe이미 설치된 경우 명령을nuget update -self사용하여 도구를 최신 버전으로 업데이트할 수 있습니다. - 이전 연속 통합 시스템과의 호환성을 위해 이전 URL은
https://nuget.org/nuget.exe현재 사용되지 않는 CLI 도구 버전 2.8.6을 제공합니다.
nuget.org/downloads 방문하여 NuGet 버전 3.3 이상을 다운로드합니다.
- 버전 5.0 이상에는 .NET Framework 버전 4.7.2 이상이 필요합니다.
- 패키지를
nuget.org게시하려면 버전 4.1.0 이상이 필요합니다. - 버전 2.8.6은 Mono와 호환되지 않습니다.
각 다운로드는
nuget.exe파일을 직접 다운로드합니다. 브라우저의 지침에 따라 선택한 폴더에 파일을 저장합니다. 다운로드 파일은 설치 관리자가 아니므로 브라우저에서 직접 파일을 실행해도 아무 것도 표시되지 않습니다.어디서나 CLI 도구를 사용하려면 파일의 폴더 위치를
nuget.exePATH 환경 변수에 추가합니다.
팁
Visual Studio의 패키지 관리자 콘솔 내에서 NuGet CLI를 사용할 수 있도록 하려면 콘솔에서 nuget.exe CLI 사용을 참조하세요.
가용성
정확한 세부 정보는 기능 가용성을 참조하세요.
- 모든 명령은 Windows에서 사용할 수 있습니다.
- 모든 명령은 Mono에서 실행되는 nuget.exe 작동하며 ,
restore및update에 대해 표시된 경우를pack제외하고 . pack,restore,deletelocals및push명령은 dotnet CLI를 통해 Mac 및 Linux에서도 사용할 수 있습니다.
명령 및 적용 가능성
패키지 만들기, 패키지 사용 및/또는 호스트에 패키지를 게시하는 데 사용할 수 있는 명령 및 적용 가능성:
| 일반 명령 | 적용 가능한 역할 | NuGet 버전 | 설명 |
|---|---|---|---|
| pack | 생성 | 2.7+ | 또는 프로젝트 파일에서 .nuspec NuGet 패키지를 만듭니다. Mono에서 실행하는 경우 프로젝트 파일에서 패키지를 만드는 것은 지원되지 않습니다. |
| push | 게시 | 모두 | 패키지를 패키지 원본에 게시합니다. |
| config | 모두 | 모두 | NuGet 구성 값을 가져오거나 설정합니다. |
| help or ? | 모두 | 모두 | 명령에 대한 도움말 정보 또는 도움말을 표시합니다. |
| locals | 소비 | 3.3+ | 전역 패키지, http-cache 및 임시 폴더의 위치를 나열하고 해당 폴더의 내용을 지웁니다. |
| 복원(restore) | 소비 | 2.7+ | 사용 중인 패키지 관리 형식에서 참조하는 모든 패키지를 복원합니다. Mono에서 실행하는 경우 PackageReference 형식을 사용하여 패키지를 복원하는 것은 지원되지 않습니다. |
| setapikey | 게시, 사용 | 모두 | 해당 패키지 원본에 액세스하기 위한 키가 필요한 경우 지정된 패키지 원본에 대한 API 키를 저장합니다. |
| spec | 생성 | 모두 | .nuspec Visual Studio 프로젝트에서 파일을 생성하는 경우 토큰을 사용하여 파일을 생성합니다. |
| 보조 명령 | 적용 가능한 역할 | NuGet 버전 | 설명 |
|---|---|---|---|
| add | 게시 | 3.3+ | 계층적 레이아웃을 사용하여 HTTP가 아닌 패키지 원본에 패키지를 추가합니다. HTTP 원본의 경우 푸시를 사용합니다. |
| delete | 게시 | 모두 | 패키지 원본에서 패키지를 제거하거나 목록 해제합니다. |
| init | 생성 | 3.3+ | 계층적 레이아웃을 사용하여 폴더의 패키지를 패키지 원본에 추가합니다. |
| install | 소비 | 모두 | 현재 프로젝트에 패키지를 설치하지만 프로젝트 또는 참조 파일은 수정하지 않습니다. |
| 목록 | 소비, 게시 | 모두 | 지정된 원본의 패키지를 표시합니다. |
| mirror | 게시 | 3.2 이상에서 사용되지 않음 | 원본에서 대상 리포지토리로 패키지 및 해당 종속성을 미러링합니다. |
| search | 소비 | 5.8+ | 제공된 쿼리 문자열을 사용하여 지정된 원본을 검색합니다. |
| sources | 소비, 게시 | 모두 | 구성 파일에서 패키지 원본을 관리합니다. |
| 업데이트 | 소비 | 모두 | 프로젝트의 패키지를 사용 가능한 최신 버전으로 업데이트. Mono에서 실행할 때 지원되지 않습니다. |
다양한 명령이 다양한 환경 변수를 사용합니다.
해당 역할별 NuGet CLI 명령:
| 역할 | 명령 |
|---|---|
| 소비 | config, help, install, list, locals, restore, searchsetapikey, sourcesupdate |
| 생성 | config, help, init, packspec |
| 게시 | add, config, delete, help, list, push, setapikeysources |
예를 들어 패키지 사용과 관련된 개발자는 NuGet 명령의 하위 집합만 이해하면 됩니다.
참고 항목
명령 옵션 이름은 대/소문자를 구분하지 않습니다. 더 이상 사용되지 않는 옵션은 이 참조에 포함되지 않습니다(예: NoPrompt (대체됨 NonInteractive) 및 Verbose (대체됨 Verbosity).
지역화
NuGet.exe 진행률, 경고 및 오류 메시지는 Visual Studio와 동일한 로캘로 변환됩니다. NuGet.exe 단일 exe로 배송되며 크기 고려 사항으로 인해 가장 일반적으로 표시되는 메시지만 모든 언어로 번역됩니다.