Public/Save-EvergreenApp.ps1
|
Function Save-EvergreenApp { <# .SYNOPSIS Saves target URLs passed to this function from Evergreen output to simplify downloads. .NOTES Author: Aaron Parker Twitter: @stealthpuppy .LINK https://stealthpuppy.com/Evergreen/save.html .EXAMPLE Get-EvergreenApp -Name AdobeAcrobat | Save-EvergreenApp -Path "C:\Temp\Adobe" Description: Downloads all of the URIs returned by 'Get-EvergreenApp -Name AdobeAcrobat' to C:\Temp\Adobe\<version>. #> [OutputType([System.Management.Automation.PSObject])] [CmdletBinding(SupportsShouldProcess = $True, HelpURI = "https://stealthpuppy.com/Evergreen/save.html")] [Alias("sea")] param ( [Parameter(Mandatory = $True, Position = 0, ValueFromPipeline)] [ValidateNotNull()] [System.Management.Automation.PSObject] $InputObject, [Parameter(Mandatory = $False, Position = 1)] [ValidateScript( { If (Test-Path -Path $_ -PathType 'Container') { $True } Else { Throw "Cannot find path $_" } })] [System.String] $Path = (Resolve-Path -Path $PWD), [Parameter(Mandatory = $False, Position = 3)] [System.String] $Proxy, [Parameter(Mandatory = $False, Position = 4)] [System.Management.Automation.PSCredential] $ProxyCredential = [System.Management.Automation.PSCredential]::Empty, [Parameter(Mandatory = $False)] [System.Management.Automation.SwitchParameter] $NoProgress ) Begin { # Disable the Invoke-WebRequest progress bar for faster downloads If ($PSBoundParameters.ContainsKey("Verbose") -and !($PSBoundParameters.ContainsKey("NoProgress"))) { $ProgressPreference = [System.Management.Automation.ActionPreference]::Continue } Else { $ProgressPreference = [System.Management.Automation.ActionPreference]::SilentlyContinue } # Enable TLS 1.2 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 Write-Warning -Message "$($MyInvocation.MyCommand): This function is currently in preview. Output paths cannot be customised." } Process { # Loop through each object and download to the target path ForEach ($Object in $InputObject) { #region Validate the URI property and find the output filename If ([System.Boolean]($Object.URI)) { Write-Verbose -Message "$($MyInvocation.MyCommand): URL: $($Object.URI)." If ([System.Boolean]($Object.FileName)) { $OutFile = $Object.FileName } ElseIf ([System.Boolean]($Object.URI)) { $OutFile = Split-Path -Path $Object.URI -Leaf } } Else { Throw "$($MyInvocation.MyCommand): Object does not have valid URI property." } #endregion # Resolve $Path to build the initial value of $OutPath $OutPath = Resolve-Path -Path $Path -ErrorAction "SilentlyContinue" If ($Null -ne $OutPath) { #region Validate the Version property If ([System.Boolean]($Object.Version)) { # Build $OutPath with the "Channel", "Release", "Language", "Architecture" properties $OutPath = New-EvergreenPath -InputObject $Object -Path $OutPath Write-Verbose -Message "$($MyInvocation.MyCommand): Downloading to: $(Join-Path -Path $OutPath -ChildPath $OutFile)." } Else { Throw "$($MyInvocation.MyCommand): Object does not have valid Version property." } #endregion } Else { Throw "$($MyInvocation.MyCommand): Failed validating $Path." } #region Download the file If ($PSCmdlet.ShouldProcess($Object.URI, "Download")) { try { # Download the file $params = @{ Uri = $Object.URI OutFile = $(Join-Path -Path $OutPath -ChildPath $OutFile) UseBasicParsing = $True ErrorAction = $script:resourceStrings.Preferences.ErrorAction } If ($PSBoundParameters.ContainsKey("Proxy")) { $params.Proxy = $Proxy } If ($PSBoundParameters.ContainsKey("ProxyCredential")) { $params.ProxyCredential = $ProxyCredential } Invoke-WebRequest @params } catch [System.Exception] { Throw "$($MyInvocation.MyCommand): URL: [$($Object.URI)]. Download failed with: [$($_.Exception.Message)]" } #region Write the downloaded file path to the pipeline If (Test-Path -Path $(Join-Path -Path $OutPath -ChildPath $OutFile)) { Write-Verbose -Message "$($MyInvocation.MyCommand): Successfully downloaded: $(Join-Path -Path $OutPath -ChildPath $OutFile)." $Output = [PSCustomObject] @{ Path = $(Join-Path -Path $OutPath -ChildPath $OutFile) } Write-Output -InputObject $Output } } #endregion } } End { Remove-Variable -Name "Output", "params", "OutPath", "OutFile" Write-Verbose -Message "$($MyInvocation.MyCommand): Complete." } } |