Config Command

Gets or sets NuGet config values.

Usage

nuget config -Set name=value

Options

Set One on more key-value pairs to be set in config.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget config -Set HTTP_PROXY=http://127.0.0.1 -Set HTTP_PROXY.USER=domain\user
nuget.config HTTP_PROXY

Delete Command

Deletes a package from the server.

Usage

nuget delete <package Id> <package version> [API Key] [options]

Specify the Id and version of the package to delete from the server.

Options

Source Specifies the server URL.
NoPrompt Do not prompt when deleting.
ApiKey The API key for the server.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget delete MyPackage 1.0

nuget delete MyPackage 1.0 -NoPrompt

Help Command

Displays general help information and help information about other commands.

Usage

nuget help [command]

Pass a command name to display help information for that command.

Options

All Print detailed help for all available commands.
Markdown Print detailed all help in markdown format.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.

Examples

nuget help

nuget help push

nuget ?

nuget push -?

Install Command

Installs a package using the specified sources. If no sources are specified, all sources defined in %AppData%\NuGet\NuGet.config are used. If NuGet.config specifies no sources, uses the default NuGet feed.

Usage

nuget install packageId|pathToPackagesConfig [options]

Specify the id and optionally the version of the package to install. If a path to a packages.config file is used instead of an id, all the packages it contains are installed.

Options

Source A list of packages sources to use for the install.
OutputDirectory Specifies the directory in which packages will be installed. If none specified, uses the current directory.
Version The version of the package to install.
ExcludeVersion If set, the destination folder will contain only the package name, not the version number
Prerelease Allows prerelease packages to be installed. This flag is not required when restoring packages by installing from packages.config.
NoCache Disable looking up packages from local machine cache.
RequireConsent Checks if package restore consent is granted before installing a package.
SolutionDirectory Solution root for package restore.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
FileConflictAction The action to take, when asked to overwrite or ignore existing files referenced by the project: Overwrite, Ignore, None.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget install elmah

nuget install packages.config

nuget install ninject -o c:\foo

List Command

Displays a list of packages from a given source. If no sources are specified, all sources defined in %AppData%\NuGet\NuGet.config are used. If NuGet.config specifies no sources, uses the default NuGet feed.

Usage

nuget list [search terms] [options]

Specify optional search terms.

Options

Source A list of packages sources to search.
Verbose Displays a detailed list of information for each package.
AllVersions List all versions of a package. By default, only the latest package version is displayed.
Prerelease Allow prerelease packages to be shown.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget list

nuget list -verbose -allversions

Mirror Command

Mirrors a package and its dependencies from the specified source repositories to the target repository.

Note: to enable this command, navigate to http://build.nuget.org/ (there's a Guest log in option), copy NuGet.ServerExtensions.dll from Artifacts,CommandLine.ServerExtensions to your local disk in the same folder than NuGet.exe.

Usage

nuget mirror packageId|pathToPackagesConfig listUrlTarget publishUrlTarget [options]

Specify the id of the package to mirror, the url to query the target repository (list command) and the url to push packages to the target repository. If a path to a packages.config file is used instead of a package id, all the packages it contains are mirrored to the given version (if specified) or latest otherwise. Assuming you're targeting a private repository under http://machine/repo installed using NuGet.Server, the list and push urls will be http://machine/repo/nuget and http://machine/repo/api/v2/package respectively.

Options

Source A list of packages sources to use for the finding packages to mirror. If no sources are specified, the ones defined in the default NuGet config file are used. If the default NuGet config file specifies no sources, uses the default NuGet feed.
Version The version of the package to install. If not specified, latest version is mirrored.
ApiKey The API key for pushing to the target repository. If not specified, the one specified in the default NuGet config file is used.
Prerelease When set, "latest" when specifying no version for a package id (as command argument or in packages.config) includes pre-release packages.
Timeout Specifies the timeout for pushing to a server in seconds. Defaults to 300 seconds (5 minutes).
NoCache By default a local cache is used as a fallback when a package or a package dependency is not found in the specified source(s). If you want to ensure only packages from the specified sources are used, set the NoCache option. If you want instead to maximize chances of finding packages, do not set this option.
NoOp Log what would be done without actually doing it. Assumes success for push operations.
Help help

Examples

nuget mirror packages.config  http://MyRepo/ES/nuget http://MyRepo/ES/api/v2/package -source https://nuget.org/api/v2 -apikey myApiKey -NoCache

nuget mirror Microsoft.AspNet.Mvc http://MyRepo/ES/nuget http://MyRepo/ES/api/v2/package -version 4.0.20505.0

nuget mirror Microsoft.Net.Http http://MyRepo/ES/nuget http://MyRepo/ES/api/v2/package -prerelease

Pack Command

Creates a NuGet package based on the specified nuspec or project file.

Usage

nuget pack <nuspec | project> [options]

Specify the location of the nuspec or project file to create a package.

Options

OutputDirectory Specifies the directory for the created NuGet package file. If not specified, uses the current directory.
BasePath The base path of the files defined in the nuspec file.
Verbose Shows verbose output for package building.
Version Overrides the version number from the nuspec file.
Exclude Specifies one or more wildcard patterns to exclude when creating a package.
Symbols Determines if a package containing sources and symbols should be created. When specified with a nuspec, creates a regular NuGet package file and the corresponding symbols package.
Tool Determines if the output files of the project should be in the tool folder.
Build Determines if the project should be built before building the package.
NoDefaultExcludes Prevent default exclusion of NuGet package files and files and folders starting with a dot e.g. .svn.
NoPackageAnalysis Specify if the command should not run package analysis after building the package.
IncludeReferencedProjects Include referenced projects either as dependencies or as part of the package. If a referenced project has a corresponding nuspec file that has the same name as the project, then that referenced project is added as a dependency. Otherwise, the referenced project is added as part of the package.
ExcludeEmptyDirectories Prevent inclusion of empty directories when building the package.
Properties Provides the ability to specify a semicolon ";" delimited list of properties when creating a package.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
MinClientVersion Set the minClientVersion attribute for the created package. This value will override the value of the existing minClientVersion attribute (if any) in the .nuspec file.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget pack

nuget pack foo.nuspec

nuget pack foo.csproj

nuget pack foo.csproj -Build -Symbols -Properties Configuration=Release

nuget pack foo.nuspec -Version 2.1.0

nuget pack foo.nuspec -Version 1.0.0 -MinClientVersion 2.5

Push Command

Pushes a package to the server and optionally publishes it. NuGet's default configuration is obtained by loading %AppData%\NuGet\NuGet.config, then loading any nuget.config or .nuget\nuget.config starting from root of drive and ending in current directory.

Usage

nuget push <package path> [API key] [options]

Specify the path to the package and your API key to push the package to the server.

Options

Source Specifies the server URL. If not specified, nuget.org is used unless DefaultPushSource config value is set in the NuGet config file.
Starting with NuGet 2.5, if NuGet.exe identifies a UNC/folder source, it will perform the file copy to the source.
ApiKey The API key for the server.
Timeout Specifies the timeout for pushing to a server in seconds. Defaults to 300 seconds (5 minutes).
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a

nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s http://customsource/

nuget push foo.nupkg

nuget push foo.nupkg.symbols

nuget push foo.nupkg -Timeout 360

nuget push *.nupkg

Starting with NuGet 2.5 you can now push to a UNC/Folder source
nuget.exe push -source \\mycompany\repo\ mypackage.1.0.0.nupkg 

Setapikey Command

Saves an API key for a given server URL. When no URL is provided API key is saved for the NuGet gallery.

Usage

nuget setapikey <API key> [options]

Specify the API key to save and an optional URL to the server that provided the API key.

Options

Source Server URL where the API key is valid.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget setapikey 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a

nuget setapikey 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -Source http://example.com/nugetfeed

Sources Command

Provides the ability to manage list of sources located in %AppData%\NuGet\NuGet.config

Usage

nuget sources <List|Add|Remove|Enable|Disable|Update> -Name [name] -Source [source]

Options

Name Name of the source.
Source Path to the package(s) source.
UserName UserName to be used when connecting to an authenticated source.
Password Password to be used when connecting to an authenticated source.
StorePasswordInClearText Do not encrypt the password and store it in clear text. (Default: False)
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Spec Command

Generates a nuspec for a new package. If this command is run in the same folder as a project file (.csproj, .vbproj, .fsproj), it will create a tokenized nuspec file.

Usage

nuget spec [package id]

Options

AssemblyPath Assembly to use for metadata.
Force Overwrite nuspec file if it exists.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget spec

nuget spec MyPackage

nuget spec -a MyAssembly.dll

Update Command

Update packages to latest available versions. This command also updates NuGet.exe itself.

Usage

nuget update <packages.config|solution>

Options

Source A list of package sources to search for updates.
Id Package ids to update.
RepositoryPath Path to the local packages folder (location where packages are installed).
Safe Looks for updates with the highest version available within the same major and minor version as the installed package.
Self Update the running NuGet.exe to the newest version available from the server.
Verbose Show verbose output while updating.
Prerelease Allows updating to prerelease versions. This flag is not required when updating prerelease packages that are already installed.
Help help
Verbosity Display this amount of details in the output: normal, quiet, detailed.
NonInteractive Do not prompt for user input or confirmations.
FileConflictAction The action to take, when asked to overwrite or ignore existing files referenced by the project: Overwrite, Ignore, None.
ConfigFile The NuGet configuation file. If not specified, file %AppData%\NuGet\NuGet.config is used as configuration file.

Examples

nuget update

nuget update -Safe

nuget update -Self