The Choco New Command
Usage
choco new <name> [<options/switches>] [<property=value> <propertyN=valueN>]
Possible properties to pass:
- packageversion
- maintainername
- maintainerrepo
- installertype
- url
- url64
- silentargs
Examples
choco new bob
choco new bob -a --version 1.2.0 maintainername="'This guy'"
choco new bob silentargs="'/S'" url="'https://somewhere/out/there.msi'"
choco new bob --outputdirectory Packages
NOTE: See scripting in how to pass arguments (choco -?
) for how to
write proper scripts and integrations.
Exit Codes
Exit codes that normally result from running this command.
Normal:
- 0: operation was successful, no issues detected
- –1 or 1: an error has occurred
If you find other exit codes that we have not yet documented, please file a ticket so we can document it at https://github.com/chocolatey/choco/issues/new/choose.
Options and Switches
--version=1.0.0
, it is going to look for and
try to install version 1.0.0 of every package passed. So please split
out multiple package calls when wanting to pass specific options.
Includes default options/switches (included below for completeness).
-?, --help, -h
Prints out the help menu.
-d, --debug
Debug - Show debug messaging.
-v, --verbose
Verbose - Show verbose messaging. Very verbose messaging, avoid using
under normal circumstances.
--trace
Trace - Show trace messaging. Very, very verbose trace messaging. Avoid
except when needing super low-level .NET Framework debugging. Available
in 0.10.4+.
--nocolor, --no-color
No Color - Do not show colorization in logging output. This overrides
the feature 'logWithoutColor', set to 'False'. Available in 0.10.9+.
--acceptlicense, --accept-license
AcceptLicense - Accept license dialogs automatically. Reserved for
future use.
-y, --yes, --confirm
Confirm all prompts - Chooses affirmative answer instead of prompting.
Implies --accept-license
-f, --force
Force - force the behavior. Do not use force during normal operation -
it subverts some of the smart behavior for commands.
--noop, --whatif, --what-if
NoOp / WhatIf - Don't actually do anything.
-r, --limitoutput, --limit-output
LimitOutput - Limit the output to essential information
--timeout, --execution-timeout=VALUE
CommandExecutionTimeout (in seconds) - The time to allow a command to
finish before timing out. Overrides the default execution timeout in the
configuration of 2700 seconds. '0' for infinite starting in 0.10.4.
-c, --cache, --cachelocation, --cache-location=VALUE
CacheLocation - Location for download cache, defaults to %TEMP% or value
in chocolatey.config file.
--allowunofficial, --allow-unofficial, --allowunofficialbuild, --allow-unofficial-build
AllowUnofficialBuild - When not using the official build you must set
this flag for choco to continue.
--failstderr, --failonstderr, --fail-on-stderr, --fail-on-standard-error, --fail-on-error-output
FailOnStandardError - Fail on standard error output (stderr), typically
received when running external commands during install providers. This
overrides the feature failOnStandardError.
--use-system-powershell
UseSystemPowerShell - Execute PowerShell using an external process
instead of the built-in PowerShell host. Should only be used when
internal host is failing. Available in 0.9.10+.
--no-progress
Do Not Show Progress - Do not show download progress percentages.
Available in 0.10.4+.
--proxy=VALUE
Proxy Location - Explicit proxy location. Overrides the default proxy
location of ''. Available for config settings in 0.9.9.9+, this CLI
option available in 0.10.4+.
--proxy-user=VALUE
Proxy User Name - Explicit proxy user (optional). Requires explicity
proxy (`--proxy` or config setting). Overrides the default proxy user of
'123'. Available for config settings in 0.9.9.9+, this CLI option
available in 0.10.4+.
--proxy-password=VALUE
Proxy Password - Explicit proxy password (optional) to be used with
username. Requires explicity proxy (`--proxy` or config setting) and
user name. Overrides the default proxy password (encrypted in settings
if set). Available for config settings in 0.9.9.9+, this CLI option
available in 0.10.4+.
--proxy-bypass-list=VALUE
ProxyBypassList - Comma separated list of regex locations to bypass on
proxy. Requires explicity proxy (`--proxy` or config setting). Overrides
the default proxy bypass list of ''. Available in 0.10.4+.
--proxy-bypass-on-local
Proxy Bypass On Local - Bypass proxy for local connections. Requires
explicity proxy (`--proxy` or config setting). Overrides the default
proxy bypass on local setting of 'True'. Available in 0.10.4+.
--log-file=VALUE
Log File to output to in addition to regular loggers. Available in 0.1-
0.8+.
-a, --auto, --automaticpackage
AutomaticPackage - Generate automatic package instead of normal.
Defaults to false
-t, --template, --template-name=VALUE
TemplateName - Use a named template in
C:\ProgramData\chocolatey\templates\templatename instead of built-in
template. Available in 0.9.9.9+. Manage templates as packages in 0.9.10+.
--name=VALUE
Name [Required]- the name of the package. Can be passed as first
parameter without "--name=".
--version=VALUE
Version - the version of the package. Can also be passed as the property
PackageVersion=somevalue
--maintainer=VALUE
Maintainer - the name of the maintainer. Can also be passed as the
property MaintainerName=somevalue
--out, --outdir, --outputdirectory, --output-directory=VALUE
OutputDirectory - Specifies the directory for the created Chocolatey
package file. If not specified, uses the current directory. Available in
0.9.10+.
--built-in, --built-in-template, --originaltemplate, --original-template, --use-original-template, --use-built-in-template
BuiltInTemplate - Use the original built-in template instead of any
override. Available in 0.9.10+.
--file, --url=VALUE
Location of binary. In [Chocolatey for Business](https://chocolatey.org/compare), file is used for auto-
detection (native installer, zip, patch/upgrade file, or remote url to
download first) to completely create a package with proper silent
arguments! Can be 32-bit or 64-bit architecture. Available in licensed
editions only (licensed version 1.4.0+, url/zip starting in 1.6.0). See
https://chocolatey.org/docs/features-create-packages-from-installers
--file64, --url64=VALUE
Optional - used when specifying both a 32-bit and a 64-bit file. Can be
an installer or a zip, or remote url to download. Available in licensed
editions only (licensed version 1.6.0+).
--keepremote, --keep-remote, --originallocation, --original-location, --useoriginallocation, --use-original-location, --useoriginalfileslocation, --use-original-files-location
Use Original Files Location - when using file or url, use the original
location in packaging. Available in [licensed editions](https://chocolatey.org/compare) only (licensed
version 1.6.0+).
--checksum, --downloadchecksum, --download-checksum=VALUE
Download Checksum - checksum to verify File/Url with. Defaults to empty.
Available in [licensed editions](https://chocolatey.org/compare) only (licensed version 1.7.0+).
--checksum64, --checksumx64, --downloadchecksumx64, --download-checksum-x64=VALUE
Download Checksum 64-bit - checksum to verify File64/Url64 with.
Defaults to empty. Available in [licensed editions](https://chocolatey.org/compare) only (licensed version
1.7.0+).
--checksumtype, --checksum-type, --downloadchecksumtype, --download-checksum-type=VALUE
Download Checksum Type - checksum type for File/Url (and optional
separate 64-bit files when specifying both). Used in conjunction with
Download Checksum and Download Checksum 64-bit. Available values are
'md5', 'sha1', 'sha256' or 'sha512'. Defaults to 'sha256'. Available in
Business editions only (licensed version 1.7.0+).
--pauseonerror, --pause-on-error
Pause on Error - Pause when there is an error with creating the package.
Available in [licensed editions](https://chocolatey.org/compare) only (licensed version 1.7.0+).
--buildpackage, --build-package, --build-packages
Build Package - Attempt to compile the package after creating it.
Available in [licensed editions](https://chocolatey.org/compare) only (licensed version 1.7.0+).
--fromprograms, --from-programs, --fromprogramsandfeatures, --from-programs-and-features
Generate Packages From Installed Software - Generate packages from the
installed software on a system (does not handle dependencies). Available
in Business editions only (licensed version 1.8.0+).
--removearchitecture, --removearchitecturefromname, --remove-architecture, --remove-architecture-from-name
Remove Architecture From Name - Remove x86, x64, 64-bit, etc from the
package id. Default setting is to remove architecture. Available in
Business editions only (licensed version 1.8.0+).
--includearchitecture, --includearchitectureinname, --include-architecture, --include-architecture-in-name
Include Architecture in Package Name - Leave x86, x64, 64-bit, etc as
part of the package id. Default setting is to remove architecture.
Available in Business editions only (licensed version 1.8.0+).
NOTE: This documentation has been automatically generated from choco new -h
.
Test Your Skills!
You must be logged in to take this test. Don't have an account yet? Register Now
Log On