JhcAdoRest.psm1
|
function Invoke-JhcAdoRestPipelinePreviewRun { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory)] [System.String] $PipelineId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $RefName, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 4, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 5, Mandatory = $false)] [System.String] $ApiVersion = '7.1-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment." } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment." } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment." } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/pipelines/' + $PipelineId + '/preview?&api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $body = "{ `n `"PreviewRun`": true `n}" $ct = 'application/json' } process { if($null -ne $RefName){ $body = "{ `n `"resources`": { `n `"repositories`": { `n `"self`": { `n `"refName`": `"refs/heads/$($RefName)`" `n } `n } `n }, `n `"previewRun`": true `n} `n" } Invoke-RestMethod -Uri $uri -Headers $header -Method POST -Body $body -ContentType $ct } end {} } function Invoke-JhcAdoRestBuildDefinition { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $PipelineId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.1-preview.7' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/build/definitions/' + $PipelineId + '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestBuildList { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $PipelineId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Top = 1, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 4, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 5, Mandatory = $false)] [System.String] $ApiVersion = '6.1-preview.7' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/build/builds?definitions=' + $PipelineId + '&$top=' + $Top + '&api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestPipeline { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $PipelineId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.0-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/pipelines/' + $PipelineId + '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestPipelineRuns { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $true)] [System.String] $PipelineId, [Parameter(Position = 1, Mandatory = $false)] [System.String] $RunId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.0-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/pipelines/' + $PipelineId if ($RunId) { $uri += '/runs/' + $RunId + '?api-version=' } else { $uri += '/runs?api-version=' } $uri += $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestBuild { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $BuildId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.1-preview.7' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/build/builds/' + $BuildId + '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestBuildTimeline { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $BuildId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '7.1-preview.2' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/build/builds/' + $BuildId + '/timeline/?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestBuildListArtifacts { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $BuildId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.0' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/build/builds/' + $BuildId + '/artifacts?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestGitPullRequest { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory)] [System.String] $RepositoryId, [Parameter(Position = 2, Mandatory)] [System.String] $PullRequestId, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 4, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 5, Mandatory = $false)] [System.String] $ApiVersion = '6.1-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/git//repositories/' + $RepositoryId + '/pullrequests/' + $PullRequestId + '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestGitListRepos { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 1, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 2, Mandatory = $false)] [System.String] $ApiVersion = '7.1-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } # GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1-preview.1 $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/git/repositories' + '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestGitListRefs { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory)] [System.String] $RepositoryId, [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '7.1-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } # GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/refs?api-version=7.1-preview.1 $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/git/repositories/' + $RepositoryId + '/refs?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestGitListItem { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory)] [System.String] $RepositoryId, [Parameter(Position = 2)] [ValidateSet("none", "oneLevel", "oneLevelPlusNestedEmptyFolders", "full")] [System.String] $RecursionLevel = "none", [Parameter(Position = 3, Mandatory = $false)] [System.String] $ScopePath, [Parameter(Position = 4, Mandatory = $false)] [System.String] $RefName, [Parameter(Position = 5, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 6, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 7, Mandatory = $false)] [System.String] $ApiVersion = '7.1-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } # GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/items?api-version=7.1-preview.1 # GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/items?scopePath={scopePath}&recursionLevel={recursionLevel}&includeContentMetadata={includeContentMetadata}&latestProcessedChange={latestProcessedChange}&download={download}&includeLinks={includeLinks}&$format={$format}&versionDescriptor.version={versionDescriptor.version}&versionDescriptor.versionOptions={versionDescriptor.versionOptions}&versionDescriptor.versionType={versionDescriptor.versionType}&api-version=7.1-preview.1 $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/git/repositories/' + $RepositoryId + '/items?scopePath=' + $ScopePath + '&recursionLevel=' + $RecursionLevel $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { if($null -ne $RefName) { $uri += '&versionDescriptor.version=' + $RefName + '&versionDescriptor.versionType=branch' } $uri += '&api-version=' + $ApiVersion Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestGitItem { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory)] [System.String] $RepositoryId, [Parameter(Position = 2)] [ValidateSet("none", "oneLevel", "oneLevelPlusNestedEmptyFolders", "full")] [System.String] $RecursionLevel = "none", [Parameter(Position = 3, Mandatory = $false)] [System.String] $ScopePath, [Parameter(Position = 4, Mandatory = $false)] [System.String] $RefName, [Parameter(Position = 5, Mandatory = $false)] [switch] $Download = $false, [Parameter(Position = 6, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 7, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 8, Mandatory = $false)] [System.String] $ApiVersion = '7.1-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } # GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/items?path={path}&api-version=7.1-preview.1 # GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/items?path={path}&scopePath={scopePath}&recursionLevel={recursionLevel}&includeContentMetadata={includeContentMetadata}&latestProcessedChange={latestProcessedChange}&download={download}&$format={$format}&versionDescriptor.version={versionDescriptor.version}&versionDescriptor.versionOptions={versionDescriptor.versionOptions}&versionDescriptor.versionType={versionDescriptor.versionType}&includeContent={includeContent}&resolveLfs={resolveLfs}&sanitize={sanitize}&api-version=7.1-preview.1 $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/git/repositories/' + $RepositoryId + '/items?scopePath=' + $ScopePath + '&recursionLevel=' + $RecursionLevel $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { if($null -ne $RefName) { $uri += '&versionDescriptor.version=' + $RefName + '&versionDescriptor.versionType=branch' } if($null -ne $Download){ $uri += '&download=' + $Download.ToString().ToLower(); } $uri += '&api-version=' + $ApiVersion Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestGitCommits { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $true)] [System.String] $repositoryId, [Parameter(Position = 1, Mandatory = $false)] [System.String] $itemPath, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.0' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/git/repositories/' + $repositoryId + '/commits?searchCriteria.itemPath=' + $itemPath + '&api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestListBranchPolicies{ param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $RepositoryId = $null, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '5.0' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/policy/configurations?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { $AllPolicyConfigurations = Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct if ($RepositoryId) { (($AllPolicyConfigurations).value | group-object {$_.settings.scope.repositoryId} | where-object {$_.name -eq $RepositoryId}).Group } else{ $AllPolicyConfigurations } } end {} } function Invoke-JhcAdoRestGitBranchPolicyRevision{ param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory)] [System.String] $configurationId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '5.0' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/policy/configurations/' + $configurationId + '/revisions?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestCodeSearch{ param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $true)] [System.String] $searchText, [Parameter(Position = 2, Mandatory = $false)] [System.String] $top = 1000, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 4, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 5, Mandatory = $false)] [System.String] $ApiVersion = '6.0-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment." } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment." } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment." } $uri = 'https://almsearch.dev.azure.com/' + $Organization + '/' + $Project + '/_apis/search/codesearchresults?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $body = "{ `n `"searchText`": `"$searchText`", `n `"`$top`": $top `n}" $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method POST -Body $body -ContentType $ct } end {} } function Invoke-JhcAdoRestReleaseDefinition { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $DefinitionId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.0' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://vsrm.dev.azure.com/' + $Organization + '/' + $Project + '/_apis/release/definitions/' + $DefinitionId + '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestRelease { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $ReleaseId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.1-preview.8' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } # GET https://vsrm.dev.azure.com/{organization}/{project}/_apis/release/releases/{releaseId}?api-version=6.1-preview.8 $uri = 'https://vsrm.dev.azure.com/' + $Organization + '/' + $Project + '/_apis/release/releases/' + $ReleaseId + '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestAgentQueue { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $AgentQueueId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.0-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } # GET https://dev.azure.com/{organization}/{project}/_apis/distributedtask/queues?queueIds={queueIds}&api-version=6.0-preview.1 $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/distributedtask/queues?queueIds=' + $AgentQueueId + '&api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestAgentPool { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $PoolName, [Parameter(Position = 2, Mandatory = $false)] [System.String] $PoolId, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '6.0' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/_apis/distributedtask/pools?' if ($PoolId) { # https://dev.azure.com/{organization}/_apis/distributedtask/pools?poolIds=1234&api-version=6.0 $uri += 'poolIds=' + $PoolId } else { # https://dev.azure.com/{organization}/_apis/distributedtask/pools?poolName=&api-version=6.0 $uri += 'poolName=' + $PoolName } $uri += '&api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Invoke-JhcAdoRestTasks { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $TaskId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $ApiVersion = '6.0' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/_apis/distributedtask/tasks/' + $TaskId $uri += '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Select-JhcAdoRestTasks { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Value ) begin { $p = 'name', @{n='taskId'; e={$_.id}}, 'friendlyName', 'description', 'category', 'definitionType', 'author', @{n='majorVersion'; e={$_.version.major}}, @{n='minorVersion'; e={$_.version.minor}}, @{n='patchVersion'; e={$_.version.patch}}, @{n='isTest'; e={$_.version.isTest}} } process { foreach ($obj in $Value) { $obj | Select-Object -Property $p } } end {} } function Invoke-JhcAdoRestTaskGroups { param ( [Parameter(Position = 0, Mandatory = $false)] [System.Security.SecureString] $Pat = $JhcAdoRestPat, [Parameter(Position = 1, Mandatory = $false)] [System.String] $TaskGroupId, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject, [Parameter(Position = 4, Mandatory = $false)] [System.String] $ApiVersion = '7.1-preview.1' ) begin { if (-not $Pat) { throw "PAT was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestOrganization) { throw "JhcAdoRestOrganization was not found. Run Set-JhcAdoRestEnvironment" } if (-not $JhcAdoRestProject) { throw "JhcAdoRestProject was not found. Run Set-JhcAdoRestEnvironment" } $uri = 'https://dev.azure.com/' + $Organization + '/' + $Project + '/_apis/distributedtask/taskgroups/' + $TaskGroupId + '?api-version=' + $ApiVersion $header = PrepAdoRestApiAuthHeader -SecurePat $pat $ct = 'application/json' } process { Invoke-RestMethod -Uri $uri -Headers $header -Method Get -ContentType $ct } end {} } function Select-JhcAdoRestAgentQueue { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Value ) begin { $p = 'id', 'name', @{n = 'poolId'; e = { $_.pool.id } }, @{n = 'poolName'; e = { $_.pool.name } }, @{n = 'poolIsHosted'; e = { $_.pool.isHosted } }, @{n = 'poolType'; e = { $_.pool.poolType } }, @{n = 'poolSize'; e = { $_.pool.size } } } process { foreach ($obj in $Value) { $obj | Select-Object -Property $p } } end {} } function Select-JhcAdoRestAgentPool { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Value ) begin { $p = 'createdOn', 'targetSize', 'size', 'id', 'name', 'isHosted' } process { foreach ($obj in $Value) { $obj | Select-Object -Property $p } } end {} } function Select-JhcAdoRestBuildDefinition { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Value ) begin { $p = 'id', 'createdDate', 'revision', @{n = 'authoredByuniqueName'; e = { $_.authoredBy.uniqueName } }, 'path', 'name', @{n = 'processType'; e = { $_.process.type } }, @{n = 'yamlFilename'; e = { $_.process.yamlFilename } }, @{n = 'repoName'; e = { $_.repository.name } }, @{n = 'repoBranch'; e = { $_.repository.defaultBranch } }, @{n = 'pool'; e = { $_.queue.name } }, @{n = 'uiUrl'; e = { PrepAdoUiUrl -Id $_.id -Type 'BuildDefinition' } } } process { foreach ($obj in $Value) { $obj | Select-Object -Property $p } } end {} } function Select-JhcAdoRestBuild { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Value ) begin { $p = 'id', @{n='definitionId'; e = {$_.definition.id}}, 'buildNumber', 'status', 'result', 'startTime', @{n='requestedForName'; e = { $_.requestedFor.uniqueName }} } process { foreach ($obj in $Value) { $obj | Select-Object -Property $p } } end {} } function Select-JhcAdoRestGitRepo { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Obj ) begin { $p = 'id', 'name', 'defaultBranch', 'webUrl' } process { foreach ($v in $Obj.value) { $v | Select-Object -Property $p } } end {} } function Select-JhcAdoRestGitRefs { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Obj ) begin { $p = 'name', @{n='creatorName'; e={$_.creator.displayName}} } process { foreach ($v in $Obj.value) { $v | Select-Object -Property $p } } end {} } function Select-JhcAdoRestGitListItem { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Obj ) begin { $p = 'objectId', 'gitObjectType', 'commitId', 'path', 'isFolder' } process { foreach ($v in $Obj.value) { $v | Select-Object -Property $p } } end {} } function Select-JhcAdoRestReleaseDefinition { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Value, [Parameter(Position = 1, Mandatory = $false)] [switch] $ExpandArtifacts = $false, [Parameter(Position = 2, Mandatory = $false)] [switch] $ExpandPhases = $false, [Parameter(Position = 3, Mandatory = $false)] [switch] $ExpandTasks = $false, [Parameter(Position = 4, Mandatory = $false)] [System.String[]] $TaskInputPropertyList, [Parameter(Position = 5, Mandatory = $false)] [switch] $ExpandPreApprovals = $false ) begin { $p = 'id', 'createdOn', 'revision', @{n = 'createdByuniqueName'; e = { $_.createdBy.uniqueName } }, 'path', 'name', @{n = 'lastReleaseId'; e = { $_.lastRelease.id } }, @{n = 'lastReleaseName'; e = { $_.lastRelease.name } }, @{n = 'lastReleaseDate'; e = { $_.lastRelease.createdOn } }, @{n = 'uiUrl'; e = { PrepAdoUiUrl -Id $_.id -Type 'ReleaseDefinition' } } $pp = $p + @{n = 'artifactsType'; e = { $_.artifacts.type } }, @{n = 'artifactsAlias'; e = { $_.artifacts.alias } } } process { foreach ($obj in $Value) { if ($ExpandArtifacts) { foreach ($artifact in $obj.artifacts) { $obj | Select-Object -Property ($p + @{n = 'artifactType'; e = { $artifact.type } }, @{n = 'artifactAlias'; e = { $artifact.alias } }, @{n = 'artifactDefinitionId'; e = { $artifact.definitionReference.definition.id } }, @{n = 'artifactDefinitionName'; e = { $artifact.definitionReference.definition.name } }) } } elseif ($ExpandPhases -or $ExpandTasks) { foreach ($env in $obj.environments) { $line = $obj | Select-Object -Property ($p + @{n = 'envId'; e = { $env.id } }, @{n = 'envName'; e = { $env.name } }, @{n = 'conditionNames'; e={$env.conditions.name}}) if($ExpandPreApprovals) { Add-Member -InputObject $line -MemberType NoteProperty -Name 'automatedApproval' -Value $env.preDeployApprovals.approvals.isAutomated -Force if($env.preDeployApprovals.approvals.approver) { Add-Member -InputObject $line -MemberType NoteProperty -Name 'approvers' -Value $env.preDeployApprovals.approvals.approver.displayName -Force } else { Add-Member -InputObject $line -MemberType NoteProperty -Name 'approvers' -Value $null -Force } } foreach ($phase in $env.deployPhases ) { Add-Member -InputObject $line -MemberType NoteProperty -Name 'phaseId' -Value $phase.id -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'phaseName' -Value $phase.name -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'phaseType' -Value $phase.phaseType -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'agentQueueId' -Value $phase.deploymentInput.queueId -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'agentSpec' -Value $phase.deploymentInput.agentSpecification.identifier -Force if($ExpandTasks) { foreach($task in $phase.workflowTasks) { Add-Member -InputObject $line -MemberType NoteProperty -Name 'taskId' -Value $task.taskId -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'taskVersion' -Value $task.version -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'taskName' -Value $task.name -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'taskEnabled' -Value $task.enabled -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'taskDefinitionType' -Value $task.definitionType -Force if($TaskInputPropertyList) { foreach($prop in $TaskInputPropertyList) { Add-Member -InputObject $line -MemberType NoteProperty -Name $prop -Value $task.inputs.$prop -Force } } $line } } else { $line } } } } else { $obj | Select-Object -Property $pp } } } end {} } function Select-JhcAdoRestRelease { param ( [Parameter(Position = 0, Mandatory, ValueFromPipeline = $true)] [System.Object[]] $Value, [Parameter(Position = 1, Mandatory = $false)] [switch] $ExpandSteps = $false ) begin { $p = 'id', 'createdOn', 'name', 'status', 'description', 'reason', @{n = 'createdByuniqueName'; e = { $_.createdBy.uniqueName } }, @{n = 'definitionId'; e = { $_.releaseDefinition.id } }, @{n = 'definitionName'; e = { $_.releaseDefinition.name } }, @{n = 'definitionPath'; e = { $_.releaseDefinition.path } }, @{n = 'uiUrl'; e = { PrepAdoUiUrl -Id $_.id -Type 'Release' } } } process { foreach ($obj in $Value) { if ($ExpandSteps) { foreach ($env in $obj.environments) { $line = $obj | Select-Object -Property ($p + @{n = 'envName'; e = { $env.name } }, @{n = 'envStatus'; e = { $env.status } }) foreach ($phase in $env.deploySteps.releaseDeployPhases) { Add-Member -InputObject $line -MemberType NoteProperty -Name 'phaseId' -Value $phase.phaseId -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'phaseName' -Value $phase.name -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'phaseType' -Value $phase.phaseType -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'phaseStatus' -Value $phase.status -Force foreach ($job in $phase.deploymentJobs.job) { Add-Member -InputObject $line -MemberType NoteProperty -Name 'jobId' -Value $job.id -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'jobName' -Value $job.name -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'jobStatus' -Value $job.status -Force Add-Member -InputObject $line -MemberType NoteProperty -Name 'jobAgentName' -Value $job.agentName -Force $line } } } } else { $obj | Select-Object -Property $p } } } end {} } function Get-JhcAdoRestEnvironment { 'JhcAdoRestOrganization', 'JhcAdoRestProject', 'JhcAdoRestPat' | ForEach-Object { Get-Variable -Name $_ } } function Set-JhcAdoRestEnvironment { param ( [Parameter(Position = 0, Mandatory = $false)] [switch] $Reset = $false, [Parameter(Position = 1, Mandatory = $false)] [System.String] $AdoOrganization, [Parameter(Position = 2, Mandatory = $false)] [System.String] $AdoProject, [Parameter(Position = 3, Mandatory = $false)] [System.Security.SecureString] $AdoPat ) if ($Reset) { Remove-Variable -Name JhcAdoRestOrganization -Scope Global Remove-Variable -Name JhcAdoRestProject -Scope Global Remove-Variable -Name JhcAdoRestPat -Scope Global } if ($AdoOrganization) { $Global:JhcAdoRestOrganization = $AdoOrganization } if ($AdoProject) { $Global:JhcAdoRestProject = $AdoProject } if ($AdoPat) { $Global:JhcAdoRestPat = $AdoPat } PrepEnv } function PrepEnv { if ((-not $Global:JhcAdoRestOrganization) -or (-not $Global:JhcAdoRestProject) -or (-not $Global:JhcAdoRestPat)) { Write-Host -ForegroundColor Yellow -Object "Setting up environment for JhcAdoRest module." } while (-not $Global:JhcAdoRestOrganization) { $Global:JhcAdoRestOrganization = Read-Host -Prompt "Input your Azure DevOps Organization name" } while (-not $Global:JhcAdoRestProject) { $Global:JhcAdoRestProject = Read-Host -Prompt "Input your Azure DevOps Project name" } while (-not $Global:JhcAdoRestPat) { $Global:JhcAdoRestPat = Read-Host -Prompt "Input your Azure DevOps personal access token" -AsSecureString } Write-Host -ForegroundColor Green -Object "Environment is ready JhcAdoRest module." Write-Host -ForegroundColor Green -Object "Organization: $($Global:JhcAdoRestOrganization), Project: $($Global:JhcAdoRestProject), PAT: $($Global:JhcAdoRestPat)" } function PrepAdoRestApiAuthHeader { param ( [Parameter(Position = 0, Mandatory)] [System.Security.SecureString] $SecurePat ) if ($null -eq $SecurePat) { throw "Passed-in SecurePat string was null." } $pat = '' try { $us = [runtime.interopservices.Marshal]::SecureStringToGlobalAllocUnicode($SecurePat) $pat = [runtime.interopservices.Marshal]::PtrToStringAuto($us) } finally { [runtime.interopservices.Marshal]::ZeroFreeGlobalAllocUnicode($us) } $credPair = ":$($pat)" $encodedCred = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($credPair)) $header = @{'Authorization' = "Basic $encodedCred" } return $header } function PrepAdoUiUrl { param ( [Parameter(Position = 0, Mandatory)] [ValidateSet('BuildDefinition', 'Build', 'ReleaseDefinition', 'Release')] [System.String] $Type, [Parameter(Position = 1, Mandatory)] [System.String] $Id, [Parameter(Position = 2, Mandatory = $false)] [System.String] $Organization = $JhcAdoRestOrganization, [Parameter(Position = 3, Mandatory = $false)] [System.String] $Project = $JhcAdoRestProject ) $typeMap = @{ 'BuildDefinition' = '_build?definitionId'; 'Build' = '_build/results?buildId'; 'ReleaseDefinition' = '_release?_a=releases&view=all&definitionId'; 'Release' = '_releaseProgress?_a=release-pipeline-progress&releaseId' } $uri = 'https://' + $Organization + '.visualstudio.com/' + $Project + '/' + $typeMap[$Type] + '=' + $Id return $uri } |