< Back
Install-ChocolateySoftware
Post
NAME Install-ChocolateySoftware
SYNOPSIS
Install the Chocolatey Software from a URL to download the binary from.
SYNTAX
Install-ChocolateySoftware [-PackageFeedUrl <Uri>] [-Version <String>] [-ChocoTempDir <String>] [-ProxyLocation
<Uri>] [-ProxyCredential <PSCredential>] [-IgnoreProxy] [-InstallationDirectory <String>] [<CommonParameters>]
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.
PARAMETERS
-ChocolateyPackageUrl <Uri>
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
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PackageFeedUrl <Uri>
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.
Required? false
Position? named
Default value https://chocolatey.org/api/v2
Accept pipeline input? false
Accept wildcard characters? false
-Version <String>
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.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ChocoTempDir <String>
The temporary folder to extract the Chocolatey Binaries during install. This does not set the Chocolatey Cache
dir.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ProxyLocation <Uri>
Proxy url to use when downloading the Chocolatey Package for installation.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ProxyCredential <PSCredential>
Credential to authenticate to the proxy, if not specified but the ProxyLocation is set, an attempt
to use the Cached credential will be made.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IgnoreProxy [<SwitchParameter>]
Ensure the proxy is bypassed when downloading the Chocolatey Package from the URL.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-InstallationDirectory <String>
Set the Installation Directory for Chocolatey, by creating the Environment Variable. This will persist after
the installation.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Please raise issues at https://github.com/gaelcolas/Chocolatey/issues
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Install latest chocolatey software from the Community repository (non pre-release version)
Install-ChocolateySoftware
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Install latest chocolatey software from a custom internal feed
Install-ChocolateySoftware -PackageFeedUrl https://proget.mycorp.local/nuget/Choco
RELATED LINKS
SYNOPSIS
Install the Chocolatey Software from a URL to download the binary from.
SYNTAX
Install-ChocolateySoftware [-PackageFeedUrl <Uri>] [-Version <String>] [-ChocoTempDir <String>] [-ProxyLocation
<Uri>] [-ProxyCredential <PSCredential>] [-IgnoreProxy] [-InstallationDirectory <String>] [<CommonParameters>]
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.
PARAMETERS
-ChocolateyPackageUrl <Uri>
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
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PackageFeedUrl <Uri>
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.
Required? false
Position? named
Default value https://chocolatey.org/api/v2
Accept pipeline input? false
Accept wildcard characters? false
-Version <String>
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.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ChocoTempDir <String>
The temporary folder to extract the Chocolatey Binaries during install. This does not set the Chocolatey Cache
dir.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ProxyLocation <Uri>
Proxy url to use when downloading the Chocolatey Package for installation.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ProxyCredential <PSCredential>
Credential to authenticate to the proxy, if not specified but the ProxyLocation is set, an attempt
to use the Cached credential will be made.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IgnoreProxy [<SwitchParameter>]
Ensure the proxy is bypassed when downloading the Chocolatey Package from the URL.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-InstallationDirectory <String>
Set the Installation Directory for Chocolatey, by creating the Environment Variable. This will persist after
the installation.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Please raise issues at https://github.com/gaelcolas/Chocolatey/issues
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Install latest chocolatey software from the Community repository (non pre-release version)
Install-ChocolateySoftware
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Install latest chocolatey software from a custom internal feed
Install-ChocolateySoftware -PackageFeedUrl https://proget.mycorp.local/nuget/Choco
RELATED LINKS