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

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+).

Command Reference

NOTE: This documentation has been automatically generated from choco new -h.