feat: Add Team and WorkItems cmdlets

AzureDevOpsPowerShell/Private/Invoke-AzDoRestMethod.ps1

@@ -27,7 +27,7 @@ function Invoke-AzDoRestMethod {
     $QueryParameters,
 
     [Parameter(Mandatory)]
-    [ValidateSet('GET', 'POST', 'PATCH', 'DELETE')]
+    [ValidateSet('GET', 'POST', 'PATCH', 'DELETE', "PUT")]
     [string]
     $Method,
 
@@ -92,15 +92,15 @@ function Invoke-AzDoRestMethod {
   }
 
   process {
-    if ($Method -eq 'POST' -or ($Method -eq 'PATCH')) {
+    if ($Method -in @('POST', 'PATCH', "PUT")) {
       Write-Verbose "Body: $($Body | ConvertTo-Json -Depth 10)"
       $params.Body = $Body | ConvertTo-Json -Depth 10
     }
     if ($PSCmdlet.ShouldProcess($ProjectName, "Invoke Rest method on: $($PSStyle.Bold)$ProjectName$($PSStyle.Reset)")) {
       try {
         Invoke-RestMethod @params
       } catch {
-        Write-AzdoError -Message ($_ | ConvertFrom-Json).message
+        $PSCmdlet.ThrowTerminatingError((Write-AzdoError -Message ($_ | ConvertFrom-Json).message))
       }
     }
   }

AzureDevOpsPowerShell/Private/Validate-CollectionUri.ps1

@@ -8,7 +8,7 @@ function Validate-CollectionUri {
   )
 
   if ($CollectionUri -notmatch '^https:\/\/dev\.azure\.com\/\w+') {
-    Write-AzdoError "CollectionUri must be a valid Azure DevOps collection URI starting with 'https://dev.azure.com/'"
+    $PSCmdlet.ThrowTerminatingError((Write-AzdoError "CollectionUri must be a valid Azure DevOps collection URI starting with 'https://dev.azure.com/'"))
   } else {
     $true
   }

AzureDevOpsPowerShell/Private/Write-AzDoError.ps1

@@ -8,13 +8,11 @@ function Write-AzDoError {
 
 
   process {
-    $errorRec = [System.Management.Automation.ErrorRecord]::new(
+    [System.Management.Automation.ErrorRecord]::new(
       [Exception]::new($Message),
       'ErrorID',
       [System.Management.Automation.ErrorCategory]::OperationStopped,
       'TargetObject'
     )
-
-    $PScmdlet.ThrowTerminatingError($errorRec)
   }
 }

AzureDevOpsPowerShell/Public/Api/ApprovalsAndChecks/CheckConfigurations/Add-AzDoPipelineBranchControl.ps1

@@ -84,12 +84,8 @@ function Add-AzDoPipelineBranchControl {
     [int]
     $Timeout = 1440
   )
-
-  begin {
-    Write-Verbose "Starting function: Add-AzDoPipelineBranchControl"
-  }
-
   process {
+    Write-Verbose "Starting function: Add-AzDoPipelineBranchControl"
 
     foreach ($name in $ResourceName) {
 
@@ -143,12 +139,16 @@ function Add-AzDoPipelineBranchControl {
       }
 
       if ($PSCmdlet.ShouldProcess($ProjectName, "Create build-validation policy named: $($PSStyle.Bold)$PolicyName$($PSStyle.Reset)")) {
-        Invoke-AzDoRestMethod @params | ForEach-Object {
-          [PSCustomObject]@{
-            CollectionUri = $CollectionUri
-            ProjectName   = $ProjectName
-            CheckId            = $_.id
+        try {
+          Invoke-AzDoRestMethod @params | ForEach-Object {
+            [PSCustomObject]@{
+              CollectionUri = $CollectionUri
+              ProjectName   = $ProjectName
+              CheckId       = $_.id
+            }
           }
+        } catch {
+          Write-Error "Failed to create build-validation policy named: $($PolicyName) on $($ResourceType) named: $($name) in project: $($ProjectName) in collection: $($CollectionUri). Error: $_"
         }
       } else {
         Write-Verbose "Calling Invoke-AzDoRestMethod with $($params| ConvertTo-Json -Depth 10)"

AzureDevOpsPowerShell/Public/Api/Build/GeneralSettings/Set-AzDOProjectSetting.ps1

@@ -131,12 +131,8 @@ function Set-AzDoProjectSetting {
     [switch]
     $StatusBadgesArePrivate
   )
-
-begin {
-  Write-Verbose "Starting function: Set-AzDOProjectSetting"
-}
-
   process {
+    Write-Verbose "Starting function: Set-AzDOProjectSetting"
 
     $body = @{
       buildsEnabledForForks                             = [bool]$BuildsEnabledForForks

AzureDevOpsPowerShell/Public/Api/Core/Projects/Get-AzDoProject.ps1

@@ -59,12 +59,8 @@ function Get-AzDoProject {
     [string[]]
     $ProjectName
   )
-
-  begin {
-    Write-Verbose "Starting function: Get-AzDoProject"
-  }
-
   process {
+    Write-Verbose "Starting function: Get-AzDoProject"
 
     $params = @{
       uri     = "$CollectionUri/_apis/projects"
@@ -73,23 +69,22 @@ function Get-AzDoProject {
     }
 
     if ($PSCmdlet.ShouldProcess($CollectionUri, "Get Project(s)")) {
-      $result = (Invoke-AzDoRestMethod @params).value | Where-Object { -not $ProjectName -or $_.Name -in $ProjectName }
-    } else {
-      Write-Verbose "Calling Invoke-AzDoRestMethod with $($params| ConvertTo-Json -Depth 10)"
-    }
-  }
-  end {
-    if ($result) {
-      $result | ForEach-Object {
-        [PSCustomObject]@{
-          CollectionURI     = $CollectionUri
-          ProjectName       = $_.name
-          ProjectID         = $_.id
-          ProjectURL        = $_.url
-          ProjectVisibility = $_.visibility
-          State             = $_.state
+      try {
+      (Invoke-AzDoRestMethod @params).value | Where-Object { -not $ProjectName -or $_.Name -in $ProjectName } | ForEach-Object {
+          [PSCustomObject]@{
+            CollectionURI     = $CollectionUri
+            ProjectName       = $_.name
+            ProjectID         = $_.id
+            ProjectURL        = $_.url
+            ProjectVisibility = $_.visibility
+            State             = $_.state
+          }
         }
+      } catch {
+        $PSCmdlet.ThrowTerminatingError((Write-AzDoError -Message "Failed to get projects in collection '$CollectionURI' Error: $_" ))
       }
+    } else {
+      Write-Verbose "Calling Invoke-AzDoRestMethod with $($params| ConvertTo-Json -Depth 10)"
     }
   }
 }

AzureDevOpsPowerShell/Public/Api/Core/Projects/New-AzDoProject.ps1

@@ -124,12 +124,9 @@ function New-AzDoProject {
     [string]
     $Visibility = 'private'
   )
-
-  begin {
+  process {
     Write-Verbose "Starting function: New-AzDoProject"
-  }
 
-  process {
 
     $params = @{
       uri     = "$CollectionUri/_apis/projects"
@@ -160,7 +157,7 @@ function New-AzDoProject {
           if ($_ -match 'TF200019') {
             Write-Warning "Project $name already exists, trying to get it"
           } else {
-            Write-AzDoError -message $_
+            $PSCmdlet.ThrowTerminatingError((Write-AzDoError -message "Failed to create project: $name Error: $_"))
           }
         }
 
@@ -176,16 +173,10 @@ function New-AzDoProject {
         } while (
           $response.State -ne 'wellFormed'
         )
-        $result += ($response)
+        $response
       } else {
         Write-Verbose "Calling Invoke-AzDoRestMethod with $($params| ConvertTo-Json -Depth 10)"
       }
     }
   }
-
-  end {
-    if ($result) {
-      $result
-    }
-  }
 }

AzureDevOpsPowerShell/Public/Api/Core/Projects/Remove-AzDoProject.ps1

@@ -45,13 +45,8 @@ function Remove-AzDoProject {
     [string[]]
     $ProjectName
   )
-
-  begin {
-    Write-Verbose "Starting function: Remove-AzDoProject"
-    $result = @()
-  }
-
   Process {
+    Write-Verbose "Starting function: Remove-AzDoProject"
 
     foreach ($name in $ProjectName) {
 
@@ -64,16 +59,29 @@ function Remove-AzDoProject {
       }
 
       if ($PSCmdlet.ShouldProcess($CollectionUri, "Delete project named: $($PSStyle.Bold)$name$($PSStyle.Reset)")) {
-        $result += Invoke-AzDoRestMethod @params
+        try {
+          Invoke-AzDoRestMethod @params | ForEach-Object {
+            [PSCustomObject]@{
+              CollectionURI = $CollectionUri
+              ProjectName   = $name
+              ProjectID     = $_.id
+              Removed       = $true
+            }
+          }
+        } catch {
+          Write-Error "Error Deleting project '$projectname' in collectionURI '$CollectionUri' Error: $_"
+          [PSCustomObject]@{
+            CollectionURI = $CollectionUri
+            ProjectName   = $name
+            ProjectID     = $projectId
+            Removed       = $false
+          }
+          continue
+        }
       } else {
         Write-Verbose "Calling Invoke-AzDoRestMethod with $($params| ConvertTo-Json -Depth 10)"
       }
     }
   }
-
-  end {
-    if ($result) {
-      $result
-    }
-  }
 }
+

AzureDevOpsPowerShell/Public/Api/Core/TeamSettings/Get-AzDoTeamSettings.ps1

@@ -0,0 +1,87 @@
+function Get-AzDoTeamSettings {
+  <#
+.SYNOPSIS
+    Get the settings of a Team in Azure DevOps.
+.DESCRIPTION
+    Get the settings of a Team or multiple in Azure DevOps.
+.EXAMPLE
+    $Params = @{
+      CollectionUri  = "https://dev.azure.com/cantoso"
+      ProjectName    = "Playground"
+      TeamName       = "Team1"
+    }
+
+    Get-AzDoTeamSettings @Params
+
+    This example will get the settings of the team 'Team1' in the project 'Playground'.
+.OUTPUTS
+    PSObject with the settings of the team(s).
+#>
+
+  [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Low')]
+  param (
+    # Collection Uri of the organization
+    [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
+    [string]
+    $CollectionUri,
+
+    # Name of the project where the team is located
+    [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [string]
+    $ProjectName,
+
+    # Name of the team to get the settings from
+    [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [string[]]
+    $TeamName
+  )
+  process {
+    Write-Verbose "Starting function: Get-AzDoTeamSettings"
+    $CollectionUri = $CollectionUri.TrimEnd('/')
+
+    foreach ($Name in $TeamName) {
+      try {
+        $team = Get-AzDoTeam -CollectionUri $CollectionUri -ProjectName $ProjectName -TeamName $Name
+        if (-not $team) {
+          Write-Error "Team '$Name' not found in project '$ProjectName'."
+          continue
+        }
+      } catch {
+        Write-Error "Failed to get team '$Name' in project '$ProjectName'. Error: $_"
+        continue
+      }
+
+      $params = @{
+        uri     = "$CollectionUri/$ProjectName/$Name/_apis/work/teamSettings"
+        method  = 'GET'
+        version = '7.1-preview.1'
+      }
+
+      if ($PSCmdlet.ShouldProcess("Get team settings for team '$Name' in project '$ProjectName'")) {
+        try {
+          Invoke-AzDoRestMethod @params | ForEach-Object {
+            [PSCustomObject]@{
+              CollectionUri         = $CollectionUri
+              ProjectName           = $ProjectName
+              TeamName              = $Name
+              TeamId                = ($_.url -split '/')[-4]
+              BacklogIteration      = $_.backlogIteration
+              BacklogVisibilities   = $_.backlogVisibilities
+              DefaultIteration      = $_.defaultIteration
+              DefaultIterationMacro = $_.defaultIterationMacro
+              WorkingDays           = $_.workingDays
+              BugsBehavior          = $_.bugsBehavior
+              Url                   = $_.url
+            }
+          }
+        } catch {
+          Write-Error "Failed to get settings for team '$name' in $projectName Error: $_"
+          continue
+        }
+      } else {
+        Write-Verbose "Skipping team settings for team '$Name' in project '$ProjectName'."
+      }
+    }
+  }
+}