Downloads:

1,303

Downloads of v 0.0.3:

847

Last Update:

17 Jun 2018

Package Maintainer(s):

Software Author(s):

  • bcurran3

Tags:

bcurran3 windows taskbar config

Windows Taskbar (Config)

0.0.3 | Updated: 17 Jun 2018

Downloads:

1,303

Downloads of v 0.0.3:

847

Maintainer(s):

Software Author(s):

  • bcurran3

Windows Taskbar (Config) 0.0.3

All Checks are Passing

2 Passing Test


Validation Testing Passed


Verification Testing Passed

Details

To install Windows Taskbar (Config), run the following command from the command line or from PowerShell:

>

To upgrade Windows Taskbar (Config), run the following command from the command line or from PowerShell:

>

To uninstall Windows Taskbar (Config), run the following command from the command line or from PowerShell:

>

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

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

  • 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://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. Enter your internal repository url

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

4. Choose your deployment method:


choco upgrade taskbar-winconfig -y --source="'STEP 3 URL'" [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 taskbar-winconfig -y --source="'STEP 3 URL'" 
$exitCode = $LASTEXITCODE

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

Exit $exitCode

- name: Ensure taskbar-winconfig installed
  win_chocolatey:
    name: taskbar-winconfig
    state: present
    version: 0.0.3
    source: STEP 3 URL

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

Coming early 2020! Central Managment Reporting available now! More information...


chocolatey_package 'taskbar-winconfig' do
  action    :install
  version  '0.0.3'
  source   'STEP 3 URL'
end

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


Chocolatey::Ensure-Package
(
    Name: taskbar-winconfig,
    Version: 0.0.3,
    Source: STEP 3 URL
);

Requires Otter Chocolatey Extension. See docs at https://inedo.com/den/otter/chocolatey.


cChocoPackageInstaller taskbar-winconfig
{
   Name     = 'taskbar-winconfig'
   Ensure   = 'Present'
   Version  = '0.0.3'
   Source   = 'STEP 3 URL'
}

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


package { 'taskbar-winconfig':
  provider => 'chocolatey',
  ensure   => '0.0.3',
  source   => 'STEP 3 URL',
}

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


salt '*' chocolatey.install taskbar-winconfig version="0.0.3" source="STEP 3 URL"

See docs at https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.chocolatey.html.

5. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

This package was approved by moderator Pauby on 13 Jul 2018.

Description

###WHAT'S THIS ALL ABOUT?

The average person probably doesn't need this. This package is primarily for sysadmins who have to constantly configure computers and make sure they are all the same. Sure, there are other methods of doing these same functions. You can manually change the settings, it doesn't take that long. You could use GPO or a configuration manager, but not everyone has access to these tools - but you have access to Chocolatey! I put Chocolatey on just about every box I touch... so I made this Chocolatey package for (almost) super simple configuration, well, really so I can add it to my setup scripts. Installing this package is probably too complex for the average person, but it should be of good use to those who script or automate a lot of installs using Chocolatey. This is part of a series of "-winconfig" packages for configuration automation. Others include desktopicons-winconfig, explorer-winconfig, and homepages-winconfig

###FEATURES:

  • Change taskbar auto hide system tray icons YES/NO
  • Change taskbar and icon size to BIG/SMALL
  • Change taskbar location to TOP/BOTTOM/LEFT/RIGHT
  • Change taskbar locked status YES/NO
  • Change taskbar icon combining feature YES/NO
  • Use taskbar People button YES/NO (Win10 Redstone 3/FCU/b1709+)
  • Use taskbar Task view button YES/NO (Win8.1+)
  • Use taskbar Store button YES/NO
  • Use taskbar Ink Workspace button YES/NO
  • Use taskbar touch keyboard button YES/NO
  • Use Cortana on taskbar ICON/SEARCHBAR/NO
  • Use Powershell (YES) or Command Prompt (NO) from Win+X menu (Win10 Redstone 2/CU/b1703+)

###INSTALL INSTRUCTIONS:
You NEED to install taskbar-winconfig with package parameters or it will do nothing. Below is the list of settings you can change with the parameters:

  • taskbar auto hide system tray icons - /AUTOTRAY:YES or /AUTOTRAY:no
  • taskbar COMBINED icons - /COMBINED:yes or /COMBINED:no
  • taskbar CORTANA - /CORTANA:no or /CORTANA:icon or /CORTANA:searchbar
  • taskbar INK Workspace icon - /INK:yes or /INK:no
  • taskbar LOCATION - /LOCATION:top or /LOCATION:bottom or /LOCATION:left or /LOCATION:right
  • taskbar LOCKED - /LOCKED:yes or /LOCKED:no
  • taskbar PEOPLE icon - /PEOPLE:yes or /PEOPLE:no
  • taskbar SIZE - /SIZE:big or /SIZE:small
  • taskbar STORE icon - /STORE:yes or /STORE:no
  • taskbar TASKVIEW icon - /TASKVIEW:yes or /TASKVIEW:no
  • taskbar touch KEYBOARD icon - /KEYBOARD:yes or /KEYBOARD:no
  • Win+X use PowerShell - /USEPOWERSHELL:yes or /USEPOWERSHELL:no (Command Prompt)

You're desktop will blink off and return as explorer is restarted at the end of the script so the changes are immediately available.

###INSTALL EXAMPLES:

  • choco install taskbar-winconfig --params "'/LOCKED:yes /PEOPLE:no /TASKVIEW:no /STORE:no /CORTANA:no'"
  • choco install taskbar-winconfig --params "'/LOCATION:top /SIZE:small /LOCKED:yes /COMBINED:no /CORTANA:icon /AUTOTRAY:no /USEPOWERSHELL:no'"

You can set any one option or any mix of options. If you don't specify any parameters, nothing will change. Default = do nothing.

There is no upgrade path for this package. taskbar-winconfig is a "one and done" package. It is recommended you uninstall this package after install (settings will NOT revert) so that you can install it again under a different user account if necessary. Settings changes only effect the currently logged in user. Of course, you could reinstall it again with -force to change the options.

If you find taskbar-winconfig useful, please consider donating: https://www.paypal.me/bcurran3donations

PACKAGE NOTES


tools\ChocolateyInstall.ps1
$ErrorActionPreference = 'Stop'
$packageName = 'taskbar-winconfig'
$pp          = Get-PackageParameters

# Taskbar icon size - Windows 7+
if ($pp["SIZE"] -ne $null -or $pp["SIZE"] -ne '')
     {
      if ($pp["SIZE"] -eq "big" -or $pp["SIZE"] -eq "BIG" -or $pp["SIZE"] -eq "Big")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "TaskbarSmallIcons" -Value 0 -ea SilentlyContinue
          }
	  if ($pp["SIZE"] -eq 'small' -or $pp["SIZE"] -eq 'SMALL' -or $pp["SIZE"] -eq 'Small')
	      {
	       Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "TaskbarSmallIcons" -Value 1 -ea SilentlyContinue
		  }
}

# Taskbar location - Windows 7+ - thanks Matt Wrock!
if ($pp["LOCATION"] -ne $null -or $pp["LOCATION"] -ne '')
     {
	   if ($pp["LOCATION"] -eq 'bottom' -or $pp["LOCATION"] -eq 'BOTTOM' -or $pp["LOCATION"] -eq 'Bottom')
	     {
	      Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\StuckRects3" -Name Settings -Value ([byte[]] (0x28,0x00,0x00,0x00,0xff,0xff,0xff,0xff,0x02,0x00,0x00,0x00,0x03,0x00,0x00,0x00,0x3e,0x00,0x00,0x00,0x2e,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x82,0x04,0x00,0x00,0x80,0x07,0x00,0x00,0xb0,0x04,0x00,0x00)) -ea SilentlyContinue
		 }
	   if ($pp["LOCATION"] -eq 'top' -or $pp["LOCATION"] -eq 'TOP' -or $pp["LOCATION"] -eq 'Top')
	     {
	      Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\StuckRects3" -Name Settings -Value ([byte[]] (0x28,0x00,0x00,0x00,0xff,0xff,0xff,0xff,0x02,0x00,0x00,0x00,0x01,0x00,0x00,0x00,0x3e,0x00,0x00,0x00,0x2e,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x80,0x07,0x00,0x00,0x2e,0x00,0x00,0x00)) -ea SilentlyContinue
		 }
	   if ($pp["LOCATION"] -eq 'left' -or $pp["LOCATION"] -eq 'LEFT' -or $pp["LOCATION"] -eq 'Left')
	     {
	      Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\StuckRects3" -Name Settings -Value ([byte[]] (0x28,0x00,0x00,0x00,0xff,0xff,0xff,0xff,0x02,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x3e,0x00,0x00,0x00,0x2e,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x3e,0x00,0x00,0x00,0xb0,0x04,0x00,0x00)) -ea SilentlyContinue
		 }
	   if ($pp["LOCATION"] -eq 'right' -or $pp["LOCATION"] -eq 'RIGHT' -or $pp["LOCATION"] -eq 'Right')
	     {
	      Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\StuckRects3" -Name Settings -Value ([byte[]] (0x28,0x00,0x00,0x00,0xff,0xff,0xff,0xff,0x02,0x00,0x00,0x00,0x02,0x00,0x00,0x00,0x3e,0x00,0x00,0x00,0x2e,0x00,0x00,0x00,0x42,0x07,0x00,0x00,0x00,0x00,0x00,0x00,0x80,0x07,0x00,0x00,0xb0,0x04,0x00,0x00)) -ea SilentlyContinue
		 }		 
	 }

# Taskbar lock - Windows 7+
if ($pp["LOCKED"] -ne $null -or $pp["LOCKED"] -ne '')
     {
      if ($pp["LOCKED"] -eq "yes" -or $pp["LOCKED"] -eq "YES" -or $pp["LOCKED"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "TaskbarSizeMove" -Value 0 -ea SilentlyContinue
          } 
      if ($pp["LOCKED"] -eq 'no' -or $pp["LOCKED"] -eq 'NO' -or $pp["LOCKED"] -eq 'No')
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "TaskbarSizeMove" -Value 1 -ea SilentlyContinue
      	  }
}

# Combine icons - Windows 7+
if ($pp["COMBINED"] -ne $null -or $pp["COMBINED"] -ne '')
     {
      if ($pp["COMBINED"] -eq "yes" -or $pp["COMBINED"] -eq "YES" -or $pp["COMBINED"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "TaskbarGlomLevel" -Value 0 -ea SilentlyContinue
          } 
      if ($pp["COMBINED"] -eq 'full' -or $pp["COMBINED"] -eq 'FULL' -or $pp["COMBINED"] -eq 'Full')
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "TaskbarGlomLevel" -Value 1 -ea SilentlyContinue
          }
      if ($pp["COMBINED"] -eq 'no' -or $pp["COMBINED"] -eq 'NO' -or $pp["COMBINED"] -eq 'No')
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "TaskbarGlomLevel" -Value 2 -ea SilentlyContinue
          }		  
}		 

# People button - Windows 10 Redstone 3/FCU/b1709+
if ($pp["PEOPLE"] -ne $null -or $pp["PEOPLE"] -ne '')
     {
      if ($pp["PEOPLE"] -eq "yes" -or $pp["PEOPLE"] -eq "YES" -or $pp["PEOPLE"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced\People" -Name "PeopleBand" -Value 1 -ea SilentlyContinue
          } 
      if ($pp["PEOPLE"] -eq 'no' -or $pp["PEOPLE"] -eq 'NO' -or $pp["PEOPLE"] -eq 'No')
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced\People" -Name "PeopleBand" -Value 0 -ea SilentlyContinue
      	  }
}	 

# Task view button - Windows 10
if ($pp["TASKVIEW"] -ne $null -or $pp["TASKVIEW"] -ne '')
     {
      if ($pp["TASKVIEW"] -eq "yes" -or $pp["TASKVIEW"] -eq "YES" -or $pp["TASKVIEW"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "ShowTaskViewButton" -Value 1 -ea SilentlyContinue
          } 
      if ($pp["TASKVIEW"] -eq 'no' -or $pp["TASKVIEW"] -eq 'NO' -or $pp["TASKVIEW"] -eq 'No')
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "ShowTaskViewButton" -Value 0 -ea SilentlyContinue
          }
}	 

# Windows Store button - Windows 8+
if ($pp["STORE"] -ne $null -or $pp["STORE"] -ne '')
     {
      if ($pp["STORE"] -eq "yes" -or $pp["STORE"] -eq "YES" -or $pp["STORE"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "StoreAppsOnTaskbar" -Value 1 -ea SilentlyContinue
       	  } 
      if ($pp["STORE"] -eq 'no' -or $pp["STORE"] -eq 'NO' -or $pp["STORE"] -eq 'No')
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "StoreAppsOnTaskbar" -Value 0 -ea SilentlyContinue
      	  }
}	 
	 
# Windows Ink Workspace button - Windows 10
if ($pp["INK"] -ne $null -or $pp["INK"] -ne '')
     {
      if ($pp["INK"] -eq "yes" -or $pp["INK"] -eq "YES" -or $pp["INK"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\PenWorkspace" -Name "PenWorkspaceButtonDesiredVisibility" -Value 1 -ea SilentlyContinue
          } 
      if ($pp["INK"] -eq 'no' -or $pp["INK"] -eq 'NO' -or $pp["INK"] -eq 'No')
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\PenWorkspace" -Name "PenWorkspaceButtonDesiredVisibility" -Value 0 -ea SilentlyContinue
          }
}	 

# Windows touch keyboard button - Windows 10
if ($pp["KEYBOARD"] -ne $null -or $pp["KEYBOARD"] -ne '')
     {
      if ($pp["KEYBOARD"] -eq "yes" -or $pp["KEYBOARD"] -eq "YES" -or $pp["KEYBOARD"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\TabletTip\1.7" -Name "TipbandDesiredVisibility" -Value 1 -ea SilentlyContinue
          } 
      if ($pp["KEYBOARD"] -eq 'no' -or $pp["KEYBOARD"] -eq 'NO' -or $pp["KEYBOARD"] -eq 'No')
          {
            Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\TabletTip\1.7" -Name "TipbandDesiredVisibility" -Value 0 -ea SilentlyContinue
          }
}	 

# EnableAutoTray - Windows 7+
if ($pp["AUTOTRAY"] -ne $null -or $pp["AUTOTRAY"] -ne '')
     {
      if ($pp["AUTOTRAY"] -eq "yes" -or $pp["AUTOTRAY"] -eq "YES" -or $pp["AUTOTRAY"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer" -Name "EnableAutoTray" -Value 1 -ea SilentlyContinue
          } 
      if ($pp["AUTOTRAY"] -eq 'no' -or $pp["AUTOTRAY"] -eq 'NO' -or $pp["AUTOTRAY"] -eq 'No')
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer" -Name "EnableAutoTray" -Value 0 -ea SilentlyContinue
          }
}	

# Cortana  button - Windows 10
if ($pp["CORTANA"] -ne $null -or $pp["CORTANA"] -ne '')
     {
      if ($pp["CORTANA"] -eq "no" -or $pp["CORTANA"] -eq "NO" -or $pp["CORTANA"] -eq "No")
         {
          Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Search" -Name "SearchboxTaskbarMode" -Value 0 -ea SilentlyContinue
      	 } 
      if ($pp["CORTANA"] -eq 'icon' -or $pp["CORTANA"] -eq 'ICON' -or $pp["CORTANA"] -eq 'Icon')
         {
          Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Search" -Name "SearchboxTaskbarMode" -Value 1 -ea SilentlyContinue
      	 }
      if ($pp["CORTANA"] -eq 'searchbar' -or $pp["CORTANA"] -eq 'SEARCHBAR' -or $pp["CORTANA"] -eq 'Searchbar')
         {
          Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Search" -Name "SearchboxTaskbarMode" -Value 2 -ea SilentlyContinue
      	 }		 
}

# Start Menu - Windows 10 Redstone 2/CU/b1703+ use PowerShell or Command Prompt on right click Start 
if ($pp["USEPOWERSHELL"] -ne $null -or $pp["USEPOWERSHELL"] -ne '')
     {
      if ($pp["USEPOWERSHELL"] -eq "YES" -or $pp["USEPOWERSHELL"] -eq "yes" -or $pp["USEPOWERSHELL"] -eq "Yes")
          {
           Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "DontUsePowerShellOnWinX" -Value 0 -ea SilentlyContinue
          }
	  if ($pp["USEPOWERSHELL"] -eq 'NO' -or $pp["USEPOWERSHELL"] -eq 'no' -or $pp["USEPOWERSHELL"] -eq 'No')
	      {
	       Set-ItemProperty -LiteralPath "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced" -Name "DontUsePowerShellOnWinX" -Value 1 -ea SilentlyContinue
		  }
}

Stop-Process -ProcessName Explorer

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.

Version Downloads Last Updated Status
Windows Taskbar (Config) 0.0.2 187 Sunday, May 6, 2018 Approved
Windows Taskbar (Config) 0.0.1 269 Saturday, February 24, 2018 Approved

If you have a previous release of taskbar-winconfig installed, upgrading to a new version will do nothing.

###CHANGELOG:

  • 0.0.3 added USEPOWERSHELL option for Win10 Redstone 2/CU/b1703+
  • 0.0.2 added -ea SilentlyContinue so Win8 and Win10 specific features do not fail the script when trying to change settings on incompatible versions of Windows
  • 0.0.1 initial release
Discussion for the Windows Taskbar (Config) Package

Ground Rules:

  • This discussion is only about Windows Taskbar (Config) and the Windows Taskbar (Config) 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 Windows Taskbar (Config), 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