Unpacking Software Livestream

Join our monthly Unpacking Software livestream to hear about the latest news, chat and opinion on packaging, software deployment and lifecycle management!

Learn More

Chocolatey Product Spotlight

Join the Chocolatey Team on our regular monthly stream where we put a spotlight on the most recent Chocolatey product releases. You'll have a chance to have your questions answered in a live Ask Me Anything format.

Learn More

Chocolatey Coding Livestream

Join us for the Chocolatey Coding Livestream, where members of our team dive into the heart of open source development by coding live on various Chocolatey projects. Tune in to witness real-time coding, ask questions, and gain insights into the world of package management. Don't miss this opportunity to engage with our team and contribute to the future of Chocolatey!

Learn More

Calling All Chocolatiers! Whipping Up Windows Automation with Chocolatey Central Management

Webinar from
Wednesday, 17 January 2024

We are delighted to announce the release of Chocolatey Central Management v0.12.0, featuring seamless Deployment Plan creation, time-saving duplications, insightful Group Details, an upgraded Dashboard, bug fixes, user interface polishing, and refined documentation. As an added bonus we'll have members of our Solutions Engineering team on-hand to dive into some interesting ways you can leverage the new features available!

Watch On-Demand
Chocolatey Community Coffee Break

Join the Chocolatey Team as we discuss all things Community, what we do, how you can get involved and answer your Chocolatey questions.

Watch The Replays
Chocolatey and Intune Overview

Webinar Replay from
Wednesday, 30 March 2022

At Chocolatey Software we strive for simple, and teaching others. Let us teach you just how simple it could be to keep your 3rd party applications updated across your devices, all with Intune!

Watch On-Demand
Chocolatey For Business. In Azure. In One Click.

Livestream from
Thursday, 9 June 2022

Join James and Josh to show you how you can get the Chocolatey For Business recommended infrastructure and workflow, created, in Azure, in around 20 minutes.

Watch On-Demand
The Future of Chocolatey CLI

Livestream from
Thursday, 04 August 2022

Join Paul and Gary to hear more about the plans for the Chocolatey CLI in the not so distant future. We'll talk about some cool new features, long term asks from Customers and Community and how you can get involved!

Watch On-Demand
Hacktoberfest Tuesdays 2022

Livestreams from
October 2022

For Hacktoberfest, Chocolatey ran a livestream every Tuesday! Re-watch Cory, James, Gary, and Rain as they share knowledge on how to contribute to open-source projects such as Chocolatey CLI.

Watch On-Demand

Downloads:

58,246,067

Downloads of v 1.0.4:

329,434

Last Update:

12 Dec 2016

Package Maintainer(s):

Software Author(s):

  • chocolatey

Tags:

chocolatey core extension admin

Chocolatey Core Extensions

This is not the latest version of Chocolatey Core Extensions available.

  • 1
  • 2
  • 3

1.0.4 | Updated: 12 Dec 2016

Downloads:

58,246,067

Downloads of v 1.0.4:

329,434

Maintainer(s):

Software Author(s):

  • chocolatey

Chocolatey Core Extensions 1.0.4

This is not the latest version of Chocolatey Core Extensions available.

  • 1
  • 2
  • 3

All Checks are Passing

3 Passing Tests


Validation Testing Passed


Verification Testing Passed

Details

Scan Testing Successful:

No detections found in any package files

Details
Learn More

Deployment Method: Individual Install, Upgrade, & Uninstall

To install Chocolatey Core Extensions, run the following command from the command line or from PowerShell:

>

To upgrade Chocolatey Core Extensions, run the following command from the command line or from PowerShell:

>

To uninstall Chocolatey Core Extensions, run the following command from the command line or from PowerShell:

>

Deployment Method:

NOTE

This applies to both open source and commercial editions of Chocolatey.

1. Enter Your Internal Repository Url

(this should look similar to https://community.chocolatey.org/api/v2/)


2. Setup Your Environment

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

2. Get the package into your environment

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to https://community.chocolatey.org/api/v2/. Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Copy Your Script

choco upgrade chocolatey-core.extension -y --source="'INTERNAL REPO URL'" --version="'1.0.4'" [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:


choco upgrade chocolatey-core.extension -y --source="'INTERNAL REPO URL'" --version="'1.0.4'" 
$exitCode = $LASTEXITCODE

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0
}

Exit $exitCode

- name: Install chocolatey-core.extension
  win_chocolatey:
    name: chocolatey-core.extension
    version: '1.0.4'
    source: INTERNAL REPO URL
    state: present

See docs at https://docs.ansible.com/ansible/latest/modules/win_chocolatey_module.html.


chocolatey_package 'chocolatey-core.extension' do
  action    :install
  source   'INTERNAL REPO URL'
  version  '1.0.4'
end

See docs at https://docs.chef.io/resource_chocolatey_package.html.


cChocoPackageInstaller chocolatey-core.extension
{
    Name     = "chocolatey-core.extension"
    Version  = "1.0.4"
    Source   = "INTERNAL REPO URL"
}

Requires cChoco DSC Resource. See docs at https://github.com/chocolatey/cChoco.


package { 'chocolatey-core.extension':
  ensure   => '1.0.4',
  provider => 'chocolatey',
  source   => 'INTERNAL REPO URL',
}

Requires Puppet Chocolatey Provider module. See docs at https://forge.puppet.com/puppetlabs/chocolatey.


4. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

Package Approved

This package was approved as a trusted package on 12 Dec 2016.

Description

This package provides helper functions installed as a Chocolatey extension.
These functions may be used in Chocolatey install/uninstall scripts by declaring this package a dependency in your package's nuspec.


extensions\chocolatey-core.psm1
# Export functions that start with capital letter, others are private
# Include file names that start with capital letters, ignore others
$ScriptRoot = Split-Path $MyInvocation.MyCommand.Definition

$pre = ls Function:\*
ls "$ScriptRoot\*.ps1" | ? { $_.Name -cmatch '^[A-Z]+' } | % { . $_  }
$post = ls Function:\*
$funcs = compare $pre $post | select -Expand InputObject | select -Expand Name
$funcs | ? { $_ -cmatch '^[A-Z]+'} | % { Export-ModuleMember -Function $_ }

#Export-ModuleMember -Alias *
extensions\Get-AppInstallLocation.ps1
<#
.SYNOPSIS
    Get application install location

.DESCRIPTION
    Function tries to find install location in multiple places. It returns $null if all fail. The following
    locations are tried:
      - local and machine (x32 & x64) various Uninstall keys
      - x32 & x64 Program Files up to the 2nd level of depth
      - native commands available via PATH
      - locale and machine registry key SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths

    Use Verbose parameter to see which of the above locations was used for the result, if any.

.EXAMPLE
    PS> Get-AppInstallLocation choco

    Returns the install location of the application 'choco'.

.OUTPUTS
    [String] or $null
#>
function Get-AppInstallLocation {
    [CmdletBinding()]
    param(
        # Regular expression pattern
        [ValidateNotNullOrEmpty()]
        [string] $AppNamePattern
    )

    function strip($path) { if ($path.EndsWith('\')) { return $path -replace '.$' } else { $path } }

    $ErrorActionPreference = "SilentlyContinue"

    Write-Verbose "Trying local and machine (x32 & x64) Uninstall keys"
    [array] $key = Get-UninstallRegistryKey $AppNamePattern
    if ($key.Count -eq 1) {
        Write-Verbose "Trying Uninstall key property 'InstallLocation'"
        $location = $key.InstallLocation
        if ($location -and (Test-Path $location))  { return strip $location }

        Write-Verbose "Trying Uninstall key property 'UninstallString'"
        $location = $key.UninstallString.Replace('"', '')
        if ($location) { $location = Split-Path $location }
        if ($location -and (Test-Path $location))  { return strip $location }

        Write-Verbose "Trying Uninstall key property 'DisplayIcon'"
        $location = $key.DisplayIcon
        if ($location) { $location = Split-Path $location }
        if ($location -and (Test-Path $location))  { return strip $location }
    } else { Write-Verbose "Found $($key.Count) keys, aborting this method" }

    $dirs = $Env:ProgramFiles, "$Env:ProgramFiles\*\*"
    if (Get-ProcessorBits 64) { $dirs += ${ENV:ProgramFiles(x86)}, "${ENV:ProgramFiles(x86)}\*\*" }
    Write-Verbose "Trying Program Files with 2 levels depth: $dirs"
    $location = (ls $dirs | ? {$_.PsIsContainer}) -match $AppNamePattern | select -First 1 | % {$_.FullName}
    if ($location -and (Test-Path $location))  { return strip $location }

    Write-Verbose "Trying native commands on PATH"
    $location = (Get-Command -CommandType Application) -match $AppNamePattern | select -First 1 | % { Split-Path $_.Source }
    if ($location -and (Test-Path $location))  { return strip $location }

    $appPaths =  "\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths"
    Write-Verbose "Trying Registry: $appPaths"
    $location = (ls "HKCU:\$appPaths", "HKLM:\$appPaths") -match $AppNamePattern | select -First 1
    if ($location) { $location = Split-Path $location }
    if ($location -and (Test-Path $location))  { return strip $location }

    Write-Verbose "No location found"
}
extensions\Get-PackageCacheLocation.ps1
<#
.SYNOPSIS
    Get temporary location for the package based on its name and version.

.DESCRIPTION
    The function returns package cache directory within $Env:TEMP. It will not create the directory
    if it doesn't exist.

    This function is useful when you have to obtain the file using `Get-ChocolateyWebFile` in order
    to perform certain installation steps that other helpers can't do.

.EXAMPLE
    Get-PackageCacheLocation

.OUTPUTS
    [String]

.LINKS
    Get-ChocolateyWebFile
#>
function Get-PackageCacheLocation {
    [CmdletBinding()]
    param (
        # Name of the package, by default $Env:ChocolateyPackageName
        [string] $Name    = $Env:ChocolateyPackageName,
        # Version of the package, by default $Env:ChocolateyPackageVersion
        [string] $Version = $Env:ChocolateyPackageVersion
    )

    if (!$Name) { Write-Warning 'Environment variable $Env:ChocolateyPackageName is not set' }
    $res = Join-Path $Env:TEMP $Name

    if (!$Version) { Write-Warning 'Environment variable $Env:ChocolateyPackageVersion is not set' }
    $res = Join-Path $res $Version

    $res
}
extensions\Get-PackageParameters.ps1
<#
.SYNOPSIS
    Parses parameters of the package

.EXAMPLE
    Get-PackageParameters "/Shortcut /InstallDir:'c:\program files\xyz' /NoStartup" | set r
    if ($r.Shortcut) {... }
    Write-Host $r.InstallDir

.OUTPUTS
    [HashTable]
#>
function Get-PackageParameters([string] $Parameters = $Env:ChocolateyPackageParameters) {
    $res = @{}
    $re = "\/([a-zA-Z]+)(:([`"'])?([a-zA-Z0-9- _\\:\.]+)([`"'])?)?"
    $results = $Parameters | Select-String $re -AllMatches | select -Expand Matches
    foreach ($m in $results) {
        if (!$m) { continue } # must because of posh 2.0 bug: https://github.com/chocolatey/chocolatey-coreteampackages/issues/465

        $a = $m.Value -split ':'
        $opt = $a[0].Substring(1); $val = $a[1..100] -join ':'
        if ($val -match '^(".+")|(''.+'')$') {$val = $val -replace '^.|.$'}
        $res[ $opt ] = if ($val) { $val } else { $true }
    }
    $res
}
extensions\Get-UninstallRegistryKey.ps1
<#
.SYNOPSIS
    Retrieve registry key(s) for system-installed applications from an exact or wildcard search.

.DESCRIPTION
    This function will attempt to retrieve a matching registry key for an already installed application,
    usually to be used with a chocolateyUninstall.ps1 automation script.

    The function also prevents `Get-ItemProperty` from failing when handling wrongly encoded registry keys.

.PARAMETER SoftwareName
    Part or all of the Display Name as you see it in Programs and Features.
    It should be enough to be unique.

    If the display name contains a version number, such as "Launchy (2.5)", it is recommended you use a
    fuzzy search `"Launchy (*)"` (the wildcard `*`) so if Launchy auto-updates or is updated outside
    of chocolatey, the uninstall script will not fail.

    Take care not to abuse fuzzy/glob pattern searches. Be conscious of programs that may have shared
    or common root words to prevent overmatching. For example, "SketchUp*" would match two keys with software
    names "SketchUp 2016" and "SketchUp Viewer" that are different programs released by the same company.

.INPUTS
    System.String

.OUTPUTS
    PSCustomObject

.EXAMPLE
    [array]$key = Get-UninstallRegistryKey -SoftwareName "VLC media player"
    $key.UninstallString

    Exact match: software name in Programs and Features is "VLC media player"

.EXAMPLE
    [array]$key = Get-UninstallRegistryKey -SoftwareName "Gpg4win (*)"
    $key.UninstallString

    Version match: software name is "Gpg4Win (2.3.0)"

.EXAMPLE
    [array]$key = Get-UninstallRegistryKey -SoftwareName "SketchUp [0-9]*"
    $key.UninstallString

    Version match: software name is "SketchUp 2016"
    Note that the similar software name "SketchUp Viewer" would not be matched.

.LINK
    Uninstall-ChocolateyPackage
#>
function Get-UninstallRegistryKey {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory=$true, ValueFromPipeline=$true)]
        [ValidateNotNullOrEmpty()]
        [string] $SoftwareName
    )
    Write-Debug "Running 'Get-UninstallRegistryKey' for `'$env:ChocolateyPackageName`' with SoftwareName:`'$SoftwareName`'";

    $ErrorActionPreference = 'Stop'
    $local_key       = 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*'
    $machine_key     = 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*'
    $machine_key6432 = 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*'

    Write-Verbose "Retrieving all uninstall registry keys"
    [array]$keys = Get-ChildItem -Path @($machine_key6432, $machine_key, $local_key) -ea 0
    Write-Debug "Registry uninstall keys on system: $($keys.Count)"

    Write-Debug "Error handling check: `'Get-ItemProperty`' fails if a registry key is encoded incorrectly."
    [int]$maxAttempts = $keys.Count
    for ([int]$attempt = 1; $attempt -le $maxAttempts; $attempt++)
    {
        $success = $false

        try {
            [array]$foundKey = Get-ItemProperty -Path $keys.PsPath -ea 0 | ? { $_.DisplayName -like $SoftwareName }
            $success = $true
        } catch {
            Write-Debug "Found bad key."
            foreach ($key in $keys){ try{ Get-ItemProperty $key.PsPath > $null } catch { $badKey = $key.PsPath }}
            Write-Verbose "Skipping bad key: $badKey"
            [array]$keys = $keys | ? { $badKey -NotContains $_.PsPath }
        }

        if ($success) { break; }
        if ($attempt -eq 10) {
            Write-Warning "Found more than 10 bad registry keys. Run command again with `'--verbose --debug`' for more info."
            Write-Debug "Each key searched should correspond to an installed program. It is very unlikely to have more than a few programs with incorrectly encoded keys, if any at all. This may be indicative of one or more corrupted registry branches."
        }
    }

    Write-Debug "Found $($foundKey.Count) uninstall registry key(s) with SoftwareName:`'$SoftwareName`'";
    return $foundKey
}
extensions\Get-WebContent.ps1
<#
.SYNOPSIS
  Download file with choco internals

.DESCRIPTION
  This function will download a file from specified url and return it as a string.
  This command should be a replacement for ubiquitous WebClient in install scripts.

  The benefit of using this command instead of WebClient is that it correctly handles
  system or explicit proxy.

.EXAMPLE
  PS C:\> $s = Get-WebContent "http://example.com"
  PS C:\> $s -match 'Example Domain'
  True

  First command downloads html content from http://example.com and stores it in $s.
  Now you can parse and match it as a string.

.EXAMPLE
  PS C:\> $opts = @{ Headers = @{ Referer = 'http://google.com' } }
  PS C:\> $s = Get-WebContent -url "http://example.com" -options $opts

  You can set headers for http request this way.

.INPUTS
  None

.OUTPUTS
  System.String

.NOTES
  This function can only return string content.
  If you want to download a binary content, please use Get-WebFile.

.LINK
  Get-WebFile
#>
function Get-WebContent {
    [CmdletBinding()]
    param(
        # Url to download
        [string]$Url,

        # Additional options for http request.For now only Headers property supported.
        [hashtable]$Options
    )

    $filePath =  get_temp_filepath
    Get-WebFile -Url $Url -FileName $filePath -Options $Options 3>$null

    $fileContent = Get-Content $filePath -ReadCount 0 | Out-String
    Remove-Item $filePath

    $fileContent
}

function get_temp_filepath() {
    $tempDir = Get-PackageCacheLocation
    $fileName = [System.IO.Path]::GetRandomFileName()
    Join-Path $tempDir $fileName
}

extensions\Register-Application.ps1
<#
.SYNOPSIS
    Register application in the system

.DESCRIPTION
    The function will register application in the system using App Paths registry key so that you
    can start it by typing its registred name in the Windows Start menu on using run dialog (Win + R).

    To make applications available in the shell, add to your profile Set-AppKeyAliases function.

.EXAMPLE
    Register-Application 'c:\windows\notepad.exe'

    Register application using name derived from its file name.

.EXAMPLE
    Register-Application 'c:\windows\notepad.exe' -Name ntp

    Register application using explicit name.

.LINK
   Set-AppKeyAliases        - https://github.com/majkinetor/posh/blob/master/MM_Admin/Set-AppKeyAliases.ps1
   Application Registration - https://msdn.microsoft.com/en-us/library/windows/desktop/ee872121(v=vs.85).aspx

#>
function Register-Application{
    [CmdletBinding()]
    param(
        # Full path of the executable to register.
        [Parameter(Mandatory=$true)]
        [string]$ExePath,

        # Optional name to register with. By default exe name will be used.
        [string]$Name,

        # Register application only for the current user. By default registration is for the machine.
        [switch]$User
    )

    if (!(Test-Path $ExePath)) { throw "Path doesn't exist: $ExePath" }
    if (!$Name) { $Name = Split-Path $ExePath -Leaf } else { $Name = $Name + '.exe' }

    $appPathKey = "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\$Name"
    if ($User) { $appPathKey = "HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\$Name" }

    If (!(Test-Path $AppPathKey)) { New-Item "$AppPathKey" | Out-Null }
    Set-ItemProperty -Path $AppPathKey -Name "(Default)" -Value $ExePath
}

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Add to Builder Version Downloads Last Updated Status
Chocolatey Core Extensions 1.3.5.1 20489143 Thursday, November 21, 2019 Approved
Chocolatey Core Extensions 1.3.5 258670 Thursday, November 14, 2019 Approved
Chocolatey Core Extensions 1.3.4 461708 Wednesday, October 30, 2019 Approved
Chocolatey Core Extensions 1.3.3 9497503 Wednesday, October 11, 2017 Approved
Chocolatey Core Extensions 1.3.2 18963 Tuesday, October 10, 2017 Approved
Chocolatey Core Extensions 1.3.1 1513354 Tuesday, May 23, 2017 Approved
Chocolatey Core Extensions 1.3.0 326460 Friday, April 21, 2017 Approved
Chocolatey Core Extensions 1.2.0 380497 Monday, March 20, 2017 Approved
Chocolatey Core Extensions 1.1.0 229229 Thursday, February 23, 2017 Approved
Chocolatey Core Extensions 1.0.7 200076 Monday, February 13, 2017 Approved
Chocolatey Core Extensions 1.0.6 111807 Wednesday, February 1, 2017 Approved
Chocolatey Core Extensions 1.0.5 85777 Tuesday, January 24, 2017 Approved
Chocolatey Core Extensions 1.0.4 329434 Monday, December 12, 2016 Approved
Chocolatey Core Extensions 1.0.3 61394 Friday, December 9, 2016 Approved
Chocolatey Core Extensions 1.0.2 35531 Wednesday, December 7, 2016 Approved
Chocolatey Core Extensions 1.0.1 45849 Friday, December 2, 2016 Approved
Chocolatey Core Extensions 1.0 143298 Sunday, November 13, 2016 Approved
Chocolatey Core Extensions 0.1.3 130236 Monday, October 24, 2016 Approved
Chocolatey Core Extensions 0.1.2 18150 Sunday, October 23, 2016 Approved
Chocolatey Core Extensions 0.1.1 619 Sunday, October 23, 2016 Approved
Chocolatey Core Extensions 0.1.0 778 Saturday, October 22, 2016 Approved

This package has no dependencies.

Discussion for the Chocolatey Core Extensions Package

Ground Rules:

  • This discussion is only about Chocolatey Core Extensions and the Chocolatey Core Extensions package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Chocolatey Core Extensions, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus