Skip to content

Install-ChocolateySoftware

SYNOPSIS

Install the Chocolatey Software from a URL to download the binary from.

SYNTAX

FromFeedUrl (Default)

Install-ChocolateySoftware [-PackageFeedUrl <Uri>] [-Version <String>] [-ChocoTempDir <String>]
 [-ProxyLocation <Uri>] [-ProxyCredential <PSCredential>] [-IgnoreProxy] [-InstallationDirectory <String>]
 [<CommonParameters>]

FromPackageUrl

Install-ChocolateySoftware [-ChocolateyPackageUrl <Uri>] [-Version <String>] [-ChocoTempDir <String>]
 [-ProxyLocation <Uri>] [-ProxyCredential <PSCredential>] [-IgnoreProxy] [-InstallationDirectory <String>]
 [<CommonParameters>]

DESCRIPTION

Install Chocolatey Software either from a fixed URL where the chocolatey nupkg is stored, or from the url of a NuGet feed containing the Chocolatey Package. A version can be specified to lookup the Package feed for a specific version, and install it. A proxy URL and credential can be specified to fetch the Chocolatey package, or the proxy configuration can be ignored.

EXAMPLES

EXAMPLE 1

Install latest chocolatey software from the Community repository (non pre-release version)
Install-ChocolateySoftware

EXAMPLE 2

Install latest chocolatey software from a custom internal feed
Install-ChocolateySoftware -PackageFeedUrl https://proget.mycorp.local/nuget/Choco

PARAMETERS

-ChocolateyPackageUrl

Exact URL of the chocolatey package. This can be an HTTP server, a network or local path. This must be the .nupkg package as downloadable from here: https://chocolatey.org/packages/chocolatey

Type: System.Uri
Parameter Sets: FromPackageUrl
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PackageFeedUrl

Url of the NuGet Feed API to use for looking up the latest version of Chocolatey (available on that feed). This is also used when searching for a specific version, doing a lookup via an Odata filter.

Type: System.Uri
Parameter Sets: FromFeedUrl
Aliases:

Required: False
Position: Named
Default value: Https://chocolatey.org/api/v2
Accept pipeline input: False
Accept wildcard characters: False

-Version

Version to install if you want to be specific, this is the way to Install a pre-release version, as when not specified, the latest non-prerelease version is looked up from the feed defined in PackageFeedUrl.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ChocoTempDir

The temporary folder to extract the Chocolatey Binaries during install. This does not set the Chocolatey Cache dir.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProxyLocation

Proxy url to use when downloading the Chocolatey Package for installation.

Type: System.Uri
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProxyCredential

Credential to authenticate to the proxy, if not specified but the ProxyLocation is set, an attempt to use the Cached credential will be made.

Type: System.Management.Automation.PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IgnoreProxy

Ensure the proxy is bypassed when downloading the Chocolatey Package from the URL.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-InstallationDirectory

Set the Installation Directory for Chocolatey, by creating the Environment Variable. This will persist after the installation.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

Please raise issues at https://github.com/gaelcolas/Chocolatey/issues

Back to top