pxe-server/playbook/shopfloor-setup/Shopfloor/07-TaskbarLayout.ps1

# 07-TaskbarLayout.ps1 - Minimal taskbar pinner.
#
# Reads the shortcuts that 06-OrganizeDesktop.ps1 created in
# C:\Users\Public\Desktop\Shopfloor Tools\ and writes a LayoutModification.xml
# that pins them to the taskbar along with Microsoft Edge.
#
# This script does NOT create, move, or copy any shortcuts - all shortcut
# management lives in 06. 07 is the last-mile taskbar config only.
#
# Pin order (left to right): Edge, WJ Shopfloor, UDC, eDNC, NTLARS, Defect_Tracker.
#
# LayoutModification.xml is written to the Default User profile shell
# directory, which means the pins apply on FIRST LOGON of any new user
# profile. Existing profiles don't re-read the Default User template, so
# they won't pick up the pins without a manual re-pin or profile delete.
# This is a Windows design limitation - syspin.exe style hacks are the
# only workaround for existing profiles, and they're unsupported.

$ErrorActionPreference = 'Continue'

# ============================================================================
# Admin check - writing to the Default User profile requires elevation.
# ============================================================================
$isAdmin = ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
if (-not $isAdmin) {
    Write-Host ""
    Write-Host "ERROR: 07-TaskbarLayout.ps1 must run as Administrator." -ForegroundColor Red
    Write-Host "       Re-run from an elevated PowerShell." -ForegroundColor Red
    Write-Host ""
    exit 1
}

# Load site config + PC profile
. "$PSScriptRoot\lib\Get-PCProfile.ps1"

$publicDesktop      = 'C:\Users\Public\Desktop'
$shopfloorToolsDir  = Join-Path $publicDesktop 'Shopfloor Tools'
$defaultUserShell   = 'C:\Users\Default\AppData\Local\Microsoft\Windows\Shell'
$layoutXmlPath      = Join-Path $defaultUserShell 'LayoutModification.xml'

# ============================================================================
# Pin list: exact ordered list of shortcut names to pin. Each entry points
# at a .lnk file via a Windows environment-variable-expanded path. Edge is
# special-cased to its default Start Menu location since Windows maintains
# it; all other entries reference C:\Users\Public\Desktop\Shopfloor Tools\
# which 06-OrganizeDesktop.ps1 populates.
# ============================================================================
$cfgPins = Get-ProfileValue 'taskbarPins'

# An EMPTY configured list means "no pins" and must be honoured. Get-ProfileValue
# returns $null only when the key is absent from BOTH the profile and
# site-config, so $null is the real "not configured" signal. Requiring
# .Count -gt 0 as well makes "taskbarPins": [] fall through to the hardcoded
# shopfloor list - configuring "none" producing "everything", the same bug that
# put Plant Apps and Defect Tracker in a Display kiosk's Startup folder
# (Configure-PC.ps1) and machine-tool shortcuts on its desktop
# (06-OrganizeDesktop.ps1).
if ($null -ne $cfgPins) {
    $pinSpec = @($cfgPins | ForEach-Object {
        @{
            Name    = $_.name
            Path    = $_.lnkPath
            Literal = [Environment]::ExpandEnvironmentVariables($_.lnkPath)
        }
    })
} else {
    $pinSpec = @(
        @{
            Name = 'Microsoft Edge'
            Path = '%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\Microsoft Edge.lnk'
            Literal = 'C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Microsoft Edge.lnk'
        }
        @{
            Name = 'WJ Shopfloor'
            Path = '%PUBLIC%\Desktop\Shopfloor Tools\WJ Shopfloor.lnk'
            Literal = (Join-Path $shopfloorToolsDir 'WJ Shopfloor.lnk')
        }
        @{
            Name = 'UDC'
            Path = '%PUBLIC%\Desktop\Shopfloor Tools\UDC.lnk'
            Literal = (Join-Path $shopfloorToolsDir 'UDC.lnk')
        }
        @{
            Name = 'eDNC'
            Path = '%PUBLIC%\Desktop\Shopfloor Tools\eDNC.lnk'
            Literal = (Join-Path $shopfloorToolsDir 'eDNC.lnk')
        }
        @{
            Name = 'NTLARS'
            Path = '%PUBLIC%\Desktop\Shopfloor Tools\NTLARS.lnk'
            Literal = (Join-Path $shopfloorToolsDir 'NTLARS.lnk')
        }
        @{
            Name = 'Defect_Tracker'
            Path = '%PUBLIC%\Desktop\Shopfloor Tools\Defect_Tracker.lnk'
            Literal = (Join-Path $shopfloorToolsDir 'Defect_Tracker.lnk')
        }
    )
}

# ============================================================================
# Build the pin list - skip any whose .lnk is missing
# ============================================================================
Write-Host ""
Write-Host "Checking which Shopfloor Tools shortcuts exist..."

$pinPaths = @()
foreach ($pin in $pinSpec) {
    if (Test-Path -LiteralPath $pin.Literal) {
        Write-Host "  pin:   $($pin.Name) -> $($pin.Literal)"
        $pinPaths += $pin.Path
    } else {
        Write-Host "  skip:  $($pin.Name) - not found at $($pin.Literal)" -ForegroundColor DarkGray
    }
}

if ($pinPaths.Count -eq 0) {
    Write-Warning "No pins to apply (nothing found in Shopfloor Tools\). Did 06-OrganizeDesktop.ps1 run first?"
    exit 0
}

# ============================================================================
# Write LayoutModification.xml
# ============================================================================
$pinXml = ($pinPaths | ForEach-Object {
    "                <taskbar:DesktopApp DesktopApplicationLinkPath=`"$_`"/>"
}) -join "`r`n"

$layoutXml = @"
<?xml version="1.0" encoding="utf-8"?>
<LayoutModificationTemplate
    xmlns="http://schemas.microsoft.com/Start/2014/LayoutModification"
    xmlns:defaultlayout="http://schemas.microsoft.com/Start/2014/FullDefaultLayout"
    xmlns:start="http://schemas.microsoft.com/Start/2014/StartLayout"
    xmlns:taskbar="http://schemas.microsoft.com/Start/2014/TaskbarLayout"
    Version="1">
    <CustomTaskbarLayoutCollection PinListPlacement="Replace">
        <defaultlayout:TaskbarLayout>
            <taskbar:TaskbarPinList>
$pinXml
            </taskbar:TaskbarPinList>
        </defaultlayout:TaskbarLayout>
    </CustomTaskbarLayoutCollection>
</LayoutModificationTemplate>
"@

try {
    if (-not (Test-Path -LiteralPath $defaultUserShell)) {
        New-Item -ItemType Directory -Path $defaultUserShell -Force -ErrorAction Stop | Out-Null
    }
    # -ErrorAction Stop so Access Denied becomes a catchable terminating error
    # instead of silently falling through to the success message.
    Set-Content -LiteralPath $layoutXmlPath -Value $layoutXml -Encoding UTF8 -Force -ErrorAction Stop
    Write-Host ""
    Write-Host "Wrote taskbar layout with $($pinPaths.Count) pin(s) to:"
    Write-Host "  $layoutXmlPath"
    Write-Host ""
    Write-Host "Pins will apply on first logon of any NEW user profile."
} catch {
    Write-Warning "Failed to write $layoutXmlPath : $_"
    exit 1
}

exit 0