Initialize-Winget.ps1
|
<#PSScriptInfo
.VERSION 1.3 .GUID df32c5bb-3f4a-46d3-9304-96addbf693f4 .AUTHOR Jonathan Pitre .TAGS Winget Intune Autopilot PowerShell Automation .RELEASENOTES 1.3 - 2025-06-02 - Fixed try/catch block - Improved logging and error handling - Improved winget.exe path detection 1.2 - 2025-05-30 - Removed dependency on PSAppDeployToolkit.WinGet - Fixed error "Find-ADTWinGetPackage -Id Microsoft.AppInstaller -Count 1 -Source winget" - Improved logging and error handling 1.1 - 2025-05-30 - Fixed "Failed to execute Winget command: Cannot validate argument on parameter 'Id'" - Improved logging and error handling 1.0 - 2025-05-28 - Initial release #> <# .SYNOPSIS A PowerShell script that initializes and verifies WinGet installation, with automatic repair capabilities. Specifically designed to resolve WinGet issues during Windows Autopilot deployment. .DESCRIPTION This script ensures WinGet is properly installed and functional. It will: 1. Verify WinGet can find packages using the 'Microsoft.WinGet.Client' module. 2. Attempt to repair WinGet if package search fails. 3. Install WinGet and its dependencies if repair fails. 4. Locate and verify the winget.exe path. The script also ensures that necessary helper module 'Microsoft.WinGet.Client' is installed and imported. .PARAMETER WinGetId The WinGet package ID to verify functionality (e.g., "Microsoft.AppInstaller"). This is used to test if WinGet is working properly by attempting to find this package. .EXAMPLE Initialize-WinGet -WinGetId "Microsoft.AppInstaller" -Verbose # Initializes WinGet and verifies it can find the Microsoft App Installer package. .OUTPUTS The found WinGet package information if successful. .NOTES This function requires and will attempt to install/update the following PowerShell modules from the PowerShell Gallery: - 'Microsoft.WinGet.Client': Provides cmdlets to interact with the WinGet service, allowing for searching, installing, and managing packages. Administrative privileges are generally required for installing/updating these modules and for WinGet repair/installation operations. An active internet connection is needed to download modules from the PowerShell Gallery and for WinGet to function. #> [CmdletBinding()] param ( [Parameter(Mandatory = $false)] [string]$WinGetId = 'Microsoft.AppInstaller', [Parameter(Mandatory = $false)] [string]$LogPath = "$env:ProgramData\Microsoft\IntuneManagementExtension\Logs", [Parameter(Mandatory = $false)] [string]$LogFile = 'WinGet_Initialization.log' ) begin { $ProgressPreference = 'SilentlyContinue' $ErrorActionPreference = 'Stop' # Create log directory if it doesn't exist if (-not (Test-Path -Path $LogPath)) { New-Item -Path $LogPath -ItemType Directory -Force | Out-Null } # Start transcript Start-Transcript -Path (Join-Path -Path $LogPath -ChildPath $LogFile) -Force -Append Write-Host 'Starting WinGet initialization process...' -ForegroundColor Cyan # Install required modules $requiredModules = @('Microsoft.WinGet.Client') foreach ($module in $requiredModules) { if (-not (Get-Module -ListAvailable -Name $module -ErrorAction Stop)) { Write-Verbose "Installing required module: $module..." $null = Install-Module -Name $module -Force -Scope AllUsers -AllowClobber -Repository PSGallery -ErrorAction Stop } else { Write-Verbose "Updating module: $module" Update-Module -Name $module -ErrorAction SilentlyContinue } Import-Module -Name $module -Force -ErrorAction Stop } } process { function Get-WinGetPath { [CmdletBinding()] [OutputType([string])] param ( ) try { # For the system user, get the path from Program Files directly. For some systems, we can't rely on the # output of Get-AppxPackage as it'll update, but Get-AppxPackage won't reflect the new path fast enough. if ([System.Security.Principal.WindowsIdentity]::GetCurrent().IsSystem) { $winGet = Get-ChildItem -Path "$([System.Environment]::GetFolderPath([System.Environment+SpecialFolder]::ProgramFiles))\WindowsApps\Microsoft.DesktopAppInstaller*\winget.exe" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 -ExpandProperty FullName } elseif (($wingetCommand = Get-Command -Name winget.exe -ErrorAction Ignore)) { $winGet = $wingetCommand.Source } elseif ([System.IO.File]::Exists(($appxPath = "$(Get-AppxPackage -Name Microsoft.DesktopAppInstaller -AllUsers -ErrorAction SilentlyContinue | Sort-Object -Property {[version]$_.Version} -Descending | Select-Object -ExpandProperty InstallLocation -First 1)\winget.exe"))) { $winGet = $appxPath } else { Write-Warning 'Failed to find a valid path to winget.exe on this system.' Write-Host 'Please invoke [Repair-WinGetPackageManager], then try again.' } # Return the found path to the caller. return $winGet } catch { Write-Warning "Error finding winget.exe path: $($_.Exception.Message)" return $null } } # Set the arguments for the winget command $wingetArgs = @( 'search', '--id', $WinGetId, '--source', 'winget', '--count', '1', '--exact', '--accept-source-agreements', '--ignore-warnings' ) # Set the encoding to UTF8 $origEncoding = [System.Console]::OutputEncoding; [System.Console]::OutputEncoding = [System.Text.Encoding]::UTF8 try { # Verify if WinGet path can be found $winGet = Get-WinGetPath # Execute the winget command and remove any empty lines # Try to find WinGet package Write-Verbose "Attempting to find WinGet package: $WinGetId" $wingetOutput = & $winGet $wingetArgs 2>&1 | & { process { if ($_ -match '^(\w+|-+$)') { return $_.Trim() } } } if (-not $wingetOutput) { throw 'No output received from winget command' } } catch { Write-Warning "Failed to execute Winget command: $_" Write-Verbose 'Attempting to repair WinGet...' try { # Verify if WinGet path can be found $WinGet = Get-WinGetPath Write-Verbose 'Attempting to repair WinGet Package Manager.' # Try to repair WinGet first Repair-WinGetPackageManager -AllUsers -Force -Latest # Verify if repair worked by trying to find package again Write-Verbose "Verifying WinGet package after repair: $WinGetId" $wingetOutput = & $winGet $wingetArgs 2>&1 | & { process { if ($_ -match '^(\w+|-+$)') { return $_.Trim() } } } if (-not $wingetOutput) { throw 'No output received from winget command' } } catch { Write-Warning "Failed to repair WinGet: $_" Write-Verbose 'Attempting to install WinGet and dependencies...' try { # Install WinGet and dependencies $WingetInstallScriptDirectory = Join-Path -Path $env:ProgramW6432 -ChildPath 'WindowsPowerShell\Scripts' Write-Verbose "Target directory for winget-install.ps1: $WingetInstallScriptDirectory" # Ensure the target directory exists. New-Item -Force creates parent directories if needed. if (-not (Test-Path -Path $WingetInstallScriptDirectory)) { Write-Verbose "Ensuring WinGet installation script directory exists: $WingetInstallScriptDirectory" New-Item -ItemType Directory -Path $WingetInstallScriptDirectory -Force -ErrorAction SilentlyContinue | Out-Null } # Save the script to the determined target directory. # Using Save-Script instead of Install-Script to precisely control the installation path to ensure it's in the 64-bit Program Files. $WingetInstallScript = Join-Path -Path $WingetInstallScriptDirectory -ChildPath 'winget-install.ps1' Write-Verbose "Saving winget-install script to $WingetInstallScript" Save-Script -Name winget-install -Path $WingetInstallScriptDirectory -Force # Run the installation script with system context Write-Verbose "Executing WinGet installation script: $WingetInstallScript" Start-Process -FilePath "$($env:WINDIR)\SysNative\WindowsPowerShell\v1.0\powershell.exe" -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$WingetInstallScript`" -Force -ForceClose" -Wait -NoNewWindow # Verify if installation worked $WinGet = Get-WinGetPath Write-Verbose "Verifying WinGet package after installation: $WinGetId" # Try to find WinGet package $wingetOutput = & $winGet $wingetArgs 2>&1 | & { process { if ($_ -match '^(\w+|-+$)') { return $_.Trim() } } } if (-not $wingetOutput) { throw 'No output received from winget command' } } catch { Write-Warning "Failed to install WinGet: $_" Write-Verbose 'Attempting to install WinGet and dependencies with alternate method...' try { Write-Verbose "Executing WinGet installation script (alternate method): $WingetInstallScript" # Install WinGet and dependencies with alternate method Start-Process -FilePath 'powershell.exe' -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$WingetInstallScript`" -Force -ForceClose -AlternateInstallMethod" -Wait -NoNewWindow # Verify if installation worked $WinGet = Get-WinGetPath Write-Verbose "Verifying WinGet package after alternate installation: $WinGetId" # Try to find WinGet package $wingetOutput = & $winGet $wingetArgs 2>&1 | & { process { if ($_ -match '^(\w+|-+$)') { return $_.Trim() } } } if (-not $wingetOutput) { throw 'No output received from winget command' } } catch { throw "Failed to install WinGet: $_" } } } } finally { # Reset the encoding [System.Console]::OutputEncoding = $origEncoding $WinGetVersion = (& $WinGet --version).Trim('v') Write-Verbose "WinGet version: $WinGetVersion" -Verbose Write-Host "Winget.exe is installed at: $WinGet" -ForegroundColor Green Write-Host "Found WinGet package: $WinGetId" -ForegroundColor Green # Stop transcript Stop-Transcript } } |