Public/Get-PSGalleryItems.ps1
|
function Get-PSGalleryItems { <# .DESCRIPTION This script will save all versions of all scripts and modules published to the PowerShell Gallery by a given Author. The Author is specified in the manifest for each item, and is expected to be consistent for a given user. .Example $items = Get-PSGalleryItems -Author 'Alain Herve' .Example $null = Get-PSGalleryItems -Author 'Alain Herve' -OutFolder $env:HOME/my_psgallery_items This will find all items where 'Alain Herve' is listed as an author, and save them into $env:HOME/my_psgallery_items. The folder will be created if it does not exist. .LINK https://github.com/chadnpc/PsCraft/blob/main/Public/Get-PSGalleryItems.ps1 #> [CmdletBinding()][OutputType([System.Collections.Generic.List[PSGalleryItem]])] param( [Parameter(Mandatory = $true)] [ValidateNotNullOrWhiteSpace()] [Alias('Author')] [string] $AuthorName, [Parameter(Mandatory = $false)] [ValidateNotNullOrWhiteSpace()] [string] $OutFolder ) process { $Items = [System.Collections.Generic.List[PSGalleryItem]]::new(); $OutFolderExists = Test-Path -Path $OutFolder -ea Ignore if ($PSBoundParameters.ContainsKey('OutFolder')) { If (!$OutFolderExists) { Write-Console "Creating folder $OutFolder" -f LimeGreen New-Item $OutFolder -ItemType Directory } } $mSearch = [progressUtil]::WaitJob("[1/2] Retrieving all modules published by the author '$AuthorName'", { return Find-Module -Repository 'psgallery' }) $Ps_repo = [PSRepoItem[]](Receive-Job $mSearch) $Modules = $Ps_repo.Where({ ($_.Author.count -eq 1) ? ($_.Author -eq $AuthorName) : ($_.Author -contains $AuthorName) }) $Modules.ForEach({ Write-Console " Retrieving all versions of $($_.Name)" -f LimeGreen Find-Module -Name $_.Name -Repository psgallery -AllowPrerelease -AllVersions -Verbose:$false | ForEach-Object { $Items += [PSGalleryItem]@{ Name = $_.Name Version = $_.Version Path = $_.Path Repository = $_.Repository } if ($OutFolderExists) { Save-Module -Name $_.Name -RequiredVersion $_.Version -Path $OutFolder -Repository psgallery -AllowPrerelease } } } ) $sSearch = [progressUtil]::WaitJob("[2/2] Retrieving all scripts published by the author '$AuthorName'", { return Find-Script -Repository 'psgallery' }) $Ps_repo = [PSRepoItem[]](Receive-Job $sSearch) $Scripts = $Ps_repo.Where({ ($_.Author.count -eq 1) ? ($_.Author -eq $AuthorName) : ($_.Author -contains $AuthorName) }) $Scripts.ForEach({ Write-Console " Retrieving all versions of $($_.Name)" -f LimeGreen Find-Script -Name $_.Name -Repository psgallery -AllowPrerelease -AllVersions -Verbose:$false | ForEach-Object { $Items += [PSGalleryItem]@{ Name = $_.Name Version = $_.Version Path = $_.Path Repository = $_.Repository } if ($OutFolderExists) { Save-Script -Name $_.Name -RequiredVersion $_.Version -Path $OutFolder -Repository psgallery -AllowPrerelease } } } ) } end { return $Items } } |