Functions/GenXdev.Windows/Set-TaskbarAlignment.ps1
|
################################################################################ <# .SYNOPSIS Configures Windows 11+ taskbar alignment between center and left positions. .DESCRIPTION Sets the taskbar alignment in Windows 11 and newer versions by modifying the registry key 'TaskbarAl' under HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\ Explorer\Advanced. The alignment can be set to either center (value 1) or left (value 0). .PARAMETER Justify Specifies the desired taskbar alignment: 'Center' or 'Left'. This setting is converted to the appropriate registry value (1 for Center, 0 for Left). .EXAMPLE Set-TaskbarAlignment -Justify Left # Sets the Windows 11 taskbar to left alignment .EXAMPLE Set-TaskAlign Center # Uses alias to set taskbar to center alignment #> function Set-TaskbarAlignment { [CmdletBinding()] [Alias("Set-TaskAlign")] param( ######################################################################## [Parameter( Mandatory = $true, Position = 0, HelpMessage = "The taskbar alignment (Center or Left)" )] [ValidateSet("Center", "Left")] [string] $Justify ######################################################################## ) begin { # store the registry path for taskbar settings $regPath = "HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\Advanced" # log the requested alignment change for troubleshooting Write-Verbose "Setting taskbar alignment to: $Justify" } process { # convert the alignment choice to its corresponding registry value $value = if ($Justify -eq "Left") { 0 } else { 1 } # update the registry key, suppressing the output for cleaner execution $null = Set-ItemProperty -Path $regPath ` -Name "TaskbarAl" ` -Value $value # log the registry update for verification Write-Verbose "Registry value 'TaskbarAl' set to: $value" } end { } } ################################################################################ |