Public/Policy/Types/Get-AdoPolicyTypeList.ps1
|
function Get-AdoPolicyTypeList { <# .SYNOPSIS Gets a list of policy types for an Azure DevOps project. .DESCRIPTION This function retrieves policy types for an Azure DevOps project through REST API. .PARAMETER ProjectId Mandatory. The ID or name of the project. .LINK https://learn.microsoft.com/en-us/rest/api/azure/devops/policy/types/list .EXAMPLE $policyTypes = Get-AdoPolicyType -ProjectId 'my-project-001' #> [CmdletBinding()] [OutputType([String])] param ( [Parameter(Mandatory)] [string]$ProjectId, [Parameter(Mandatory = $false)] [Alias('api')] [ValidateSet('7.1', '7.2-preview.1')] [string]$ApiVersion = '7.1' ) begin { Write-Debug ('Command : {0}' -f $MyInvocation.MyCommand.Name) Write-Debug (' ProjectId : {0}' -f $ProjectId) Write-Debug (' ApiVersion : {0}' -f $ApiVersion) } process { try { $ErrorActionPreference = 'Stop' if (-not $global:AzDevOpsIsConnected) { throw 'Not connected to Azure DevOps. Please connect using Connect-AdoOrganization.' } $uriFormat = '{0}/{1}/_apis/policy/types?api-version={2}' $azDevOpsUri = ($uriFormat -f [uri]::new($global:AzDevOpsOrganization), $ProjectId, $ApiVersion) $params = @{ Method = 'GET' Uri = $azDevOpsUri Headers = ((ConvertFrom-SecureString -SecureString $global:AzDevOpsHeaders -AsPlainText) | ConvertFrom-Json -AsHashtable) } $response = Invoke-RestMethod @params -Verbose:$VerbosePreference return $response } catch { throw $_ } } end { Write-Debug ('Exit : {0}' -f $MyInvocation.MyCommand.Name) } } |