Public/Get-PSUADOPullRequestInventory.ps1
|
function Get-PSUADOPullRequestInventory { <# .SYNOPSIS Retrieves all active pull requests from accessible Azure DevOps repositories across all projects in the organization. .DESCRIPTION This function loops through each project in the specified Azure DevOps organization, retrieves repositories from each project, and then gathers all active pull requests from each repository. Results are returned as a flattened array of pull request objects. Permission errors are handled gracefully to skip projects the user cannot access. .PARAMETER Organization The name of the Azure DevOps organization. If not specified, the value from the ORGANIZATION environment variable is used. .PARAMETER PAT The Personal Access Token used for authentication. If not specified, the value from the PAT environment variable is used. .EXAMPLE PS> $PRInventory = Get-PSUADOPullRequestInventory -Organization 'omgitsolutions' -PAT 'your-pat-token' Retrieves all active pull requests across all repositories and projects under 'omgitsolutions'. .OUTPUTS System.Object[] .NOTES Author: Lakshmanachari Panuganti Date: 2 August 2025 - Initial development .LINK https://github.com/lakshmanachari-panuganti https://www.linkedin.com/in/lakshmanachari-panuganti/ https://www.powershellgallery.com/packages/OMG.PSUtilities.AzureDevOps #> [CmdletBinding()] param ( [Parameter()] [ValidateNotNullOrEmpty()] [string]$Organization = $env:ORGANIZATION, [Parameter()] [ValidateNotNullOrEmpty()] [string]$PAT = $env:PAT ) $PullRequests = [System.Collections.Generic.List[PSCustomObject]]::new() Write-Verbose "Fetching project list for organization [$Organization]..." $ProjectList = Get-PSUADOProjectList -Organization $Organization -PAT $PAT $projectCount = $ProjectList.Count $projectIndex = 0 foreach ($project in $ProjectList) { $projectIndex++ $progressActivity = "Processing project [$($project.Name)] ($projectIndex of $projectCount)" Write-Progress -Activity $progressActivity -Status "Fetching repositories..." -PercentComplete (($projectIndex / $projectCount) * 100) try { Write-Verbose "Fetching repositories for project [$($project.Name)]..." $Repositories = Get-PSUADORepositories -Project $project.Name -Organization $Organization -PAT $PAT Write-Verbose "[$($Repositories.Count)] repositories found in [$($project.Name)]" $repoCount = $Repositories.Count $repoIndex = 0 foreach ($Repository in $Repositories) { $repoIndex++ Write-Progress -Activity $progressActivity -Status "Fetching PRs from repo [$($Repository.name)] ($repoIndex of $repoCount)" -PercentComplete (($repoIndex / $repoCount) * 100) $prs = Get-PSUADOPullRequest -RepositoryId $Repository.id -Project $project.Name -Organization $Organization -PAT $PAT foreach ($pr in $prs) { $PullRequests.Add($pr) } } } catch { $exceptionMessage = $_.Exception.Message if ($exceptionMessage -notlike "*you do not have permissions*") { $PSCmdlet.ThrowTerminatingError($_) } else { Write-Warning "Skipped project [$($project.Name)] due to insufficient permissions." } } } Write-Verbose "Completed pull request inventory collection." $PullRequests.ToArray() | Select-Object * } |