Public/Get-VcList.ps1
|
Function Get-VcList { <# .SYNOPSIS Returns an array of Visual C++ Redistributables. .DESCRIPTION This function reads the Visual C++ Redistributables listed in an internal manifest or an external XML file into an array that can be passed to other VcRedist functions. A complete listing the supported and all known redistributables is included in the module. These internal manifests can be exported with Export-VcXml. .OUTPUTS System.Array .NOTES Author: Aaron Parker Twitter: @stealthpuppy .LINK https://github.com/aaronparker/Install-VisualCRedistributables .PARAMETER Xml The XML file that contains the details about the Visual C++ Redistributables. This must be in the expected format. .PARAMETER Export Defines the list of Visual C++ Redistributables to export - All Redistributables or Supported Redistributables only. Defaults to exporting the Supported Redistributables. .EXAMPLE Get-VcList Description: Return an array of the Visual C++ Redistributables from the embedded manifest .EXAMPLE Get-VcList -Xml ".\VisualCRedistributablesSupported.xml" Description: Return an array of the Visual C++ Redistributables listed in VisualCRedistributablesSupported.xml. #> [CmdletBinding(SupportsShouldProcess = $False)] [OutputType([Array])] Param ( [Parameter(Mandatory = $False, Position = 0, HelpMessage = "Path to the XML document describing the Redistributables.")] [ValidateNotNull()] [ValidateScript({ If (Test-Path $_ -PathType 'Leaf') { $True } Else { Throw "Cannot find file $_" } })] [string] $Xml = (Join-Path (Join-Path $MyInvocation.MyCommand.Module.ModuleBase "Manifests") "VisualCRedistributablesSupported.xml"), [Parameter(Mandatory = $False)] [ValidateSet('All', 'Supported')] [string] $Export = "Supported" ) Begin { Switch ( $Export ) { "All" { $Xml = Join-Path (Join-Path $MyInvocation.MyCommand.Module.ModuleBase "Manifests") "VisualCRedistributablesAll.xml" Write-Warning "This array includes unsupported Visual C++ Redistributables." } } # The array that will be returned $Output = @() } Process { # Read the specifed XML document Try { Write-Verbose "Reading XML document $Xml." [xml] $xmlDocument = Get-Content -Path $Xml -ErrorVariable xmlReadError -ErrorAction SilentlyContinue } Catch { Throw "Unable to read $Xml. $xmlReadError" } # Build the output object by compiling an array of each redistributable $xmlContent = ( Select-Xml -XPath "/Redistributables/Platform" -Xml $xmlDocument ).Node ForEach ($platform in $xmlContent) { Write-Verbose "Building array with $($platform.Release) on $($platform.Architecture)." ForEach ($redistributable in $platform.Redistributable) { Write-Verbose "Adding to array with $($redistributable.Name)" $item = New-Object PSObject $item | Add-Member -Type NoteProperty -Name 'Name' -Value $redistributable.Name $item | Add-Member -Type NoteProperty -Name 'ProductCode' -Value $redistributable.ProductCode $item | Add-Member -Type NoteProperty -Name 'URL' -Value $redistributable.URL $item | Add-Member -Type NoteProperty -Name 'Download' -Value $redistributable.Download $item | Add-Member -Type NoteProperty -Name 'Release' -Value $platform.Release $item | Add-Member -Type NoteProperty -Name 'Architecture' -Value $platform.Architecture $item | Add-Member -Type NoteProperty -Name 'ShortName' -Value $redistributable.ShortName $item | Add-Member -Type NoteProperty -Name 'Install' -Value $platform.Install $Output += $item } } } End { # Return array to the pipeline Write-Output $Output } } |