feat: Add Team and WorkItems cmdlets

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

@@ -0,0 +1,83 @@
+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
+  )
+
+  begin {
+    Write-Verbose "Starting function: Get-AzDoTeamSettings"
+    $CollectionUri = $CollectionUri.TrimEnd('/')
+    # create dynamic array to store the results
+    $result = New-Object System.Collections.Generic.List[System.Object]
+  }
+
+  process {
+    foreach ($Name in $TeamName) {
+      $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 {
+          $result += Invoke-AzDoRestMethod @params
+        } catch {
+          Write-AzdoError -Message $_
+        }
+      } else {
+        Write-Verbose "Skipping team settings for team '$Name' in project '$ProjectName'."
+      }
+    }
+  }
+
+  end {
+    if ($result) {
+      $result | ForEach-Object {
+        [PSCustomObject]@{
+          TeamId                = ($_.url -split '/')[-4]
+          BacklogIteration      = $_.backlogIteration
+          BacklogVisibilities   = $_.backlogVisibilities
+          DefualtIteration      = $_.defaultIteration
+          DefaultIterationMacro = $_.defaultIterationMacro
+          WorkingDays           = $_.workingDays
+          BugsBehavior          = $_.bugsBehavior
+          Url                   = $_.url
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,173 @@
+function Set-AzDoTeamSettings {
+  <#
+.SYNOPSIS
+    Set the settings of a Team in Azure DevOps.
+.DESCRIPTION
+    Set the settings of a Team or multiple in Azure DevOps.
+.EXAMPLE
+    $Params = @{
+      CollectionUri  = "https://dev.azure.com/cantoso"
+      ProjectName    = "Playground"
+      TeamName           = "Team1"
+      BacklogIteration = "323b04b6-2fb8-4093-94f4-fbe3bd36a19f"
+      DefaultIteration = "8c2457e8-8936-4cdc-b3aa-17b20f56c76c"
+      BugsBehavior = "off"
+      WorkingDays = @("monday", "tuesday", "wednesday", "thursday", "friday")
+      Iterations = @(
+        "8c2457e8-8936-4cdc-b3aa-17b20f56c76c",
+        "323b04b6-2fb8-4093-94f4-fbe3bd36a19f"
+      )
+      AreaPath = "ProjectName"
+      IncludeAreaChildren = $true
+    }
+
+    Set-AzDoTeamSettings @Params
+
+    This example will set the settings of the team 'Team1' in the project 'Playground'.
+#>
+  [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,
+
+    # Backlog iteration id
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [string]
+    $BacklogIteration,
+
+    # Bugs behavior
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [ValidateSet('off', 'asRequirements', 'asTasks')]
+    [string]
+    $BugsBehavior,
+
+    # Working days
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [ValidateSet('monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday')]
+    [string[]]
+    $WorkingDays,
+
+    # Iteration paths
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [string[]]
+    $Iterations,
+
+    # Area path
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [string]
+    $AreaPath,
+
+    # Include area children
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [bool]
+    $IncludeAreaChildren = $true
+  )
+
+  begin {
+    Write-Verbose "Starting function: Set-AzDoTeamSettings"
+  }
+
+  process {
+    $Team = Get-AzDoTeam -CollectionUri $CollectionUri -ProjectName $ProjectName -TeamName $TeamName -ErrorAction SilentlyContinue
+    if ($Team) {
+      # Set the team settings
+      $Settings = @{}
+      if ($BacklogIteration) {
+        $Settings.backlogIteration = $BacklogIteration
+      }
+      if ($BugsBehavior) {
+        $Settings.bugsBehavior = $BugsBehavior
+      }
+      if ($WorkingDays) {
+        $Settings.workingDays = $WorkingDays
+      }
+      $SettingsParams = @{
+        uri     = "$CollectionUri/$ProjectName/$TeamName/_apis/work/teamSettings"
+        method  = 'PATCH'
+        version = '7.1-preview.1'
+        body    = $Settings
+      }
+      try {
+        Write-Verbose "Setting team settings for team '$TeamName' in project '$ProjectName'."
+        $SettingsResult = Invoke-AzDoRestMethod @SettingsParams
+      } catch {
+        Write-AzdoError -Message $_
+      }
+
+      # Set the area path
+      if ($AreaPath) {
+        $AreaParams = @{
+          uri     = "$CollectionUri/$ProjectName/$TeamName/_apis/work/teamsettings/teamfieldvalues"
+          method  = 'PATCH'
+          version = '7.1-preview.1'
+          body    = @{
+            defaultValue = "$ProjectName\\$AreaPath"
+            values       = @(
+              @{
+                includeChildren = $IncludeAreaChildren
+                value           = "$ProjectName\\$AreaPath"
+              }
+            )
+          }
+        }
+        try {
+          Write-Verbose "Setting area path for team '$TeamName' in project '$ProjectName'."
+          $AreaResult = Invoke-AzDoRestMethod @AreaParams
+        } catch {
+          Write-AzdoError -Message $_
+        }
+      }
+
+      # Set the iteration paths
+      $IterationResult = @()
+      foreach ($Iteration in $Iterations) {
+        $IterationParams = @{
+          uri     = "$CollectionUri/$ProjectName/$TeamName/_apis/work/teamsettings/iterations"
+          method  = 'POST'
+          version = '7.1-preview.1'
+          body    = @{ id = $Iteration }
+        }
+        try {
+          Write-Verbose "Setting iteration paths for team '$TeamName' in project '$ProjectName'."
+          $IterationResult += Invoke-AzDoRestMethod @IterationParams
+        } catch {
+          Write-AzdoError -Message $_
+        }
+      }
+
+      $result += [PSCustomObject]@{
+        CollectionUri       = $CollectionUri
+        ProjectName         = $ProjectName
+        TeamName            = $TeamName
+        BacklogIteration    = $SettingsResult.backlogIteration
+        BugsBehavior        = $SettingsResult.bugsBehavior
+        WorkingDays         = $SettingsResult.workingDays
+        AreaPath            = $AreaResult.defaultValue
+        IncludeAreaChildren = $AreaResult.values.includeChildren
+        Iterations          = $IterationResult
+      }
+    } else {
+      Write-Host "Team '$TeamName' not found in project '$ProjectName', skipping."
+    }
+  }
+
+  end {
+    if ($result) {
+      $result
+    }
+    Write-Verbose "Ending function: Set-AzDoTeamSettings"
+  }
+}

AzureDevOpsPowerShell/Public/Api/Core/Teams/Get-AzDoTeam.ps1

@@ -0,0 +1,110 @@
+function Get-AzDoTeam {
+  <#
+.SYNOPSIS
+    Gets information about a team in Azure DevOps.
+.DESCRIPTION
+    Gets information about 1 team if the parameter $TeamName is filled in. Otherwise it will list all the teams's.
+.EXAMPLE
+    $Params = @{
+        CollectionUri = "https://dev.azure.com/contoso"
+    }
+    Get-AzDoTeam -CollectionUri = "https://dev.azure.com/contoso"
+
+    This example will list all the teams in the organization.
+.EXAMPLE
+    $Params = @{
+        CollectionUri = "https://dev.azure.com/contoso"
+        ProjectName = "Project 1"
+    }
+    Get-AzDoTeam -CollectionUri = "https://dev.azure.com/contoso" -ProjectName = "Project 1"
+
+    This example will list all the teams contained in 'Project 1'.
+.EXAMPLE
+    $Params = @{
+        CollectionUri = "https://dev.azure.com/contoso"
+        TeamName "Team 1"
+    }
+    Get-AzDoTeam -CollectionUri = "https://dev.azure.com/contoso" -TeamName "Team 1"
+
+    This example will fetch information about the team with the name 'Team 1'.
+.EXAMPLE
+    $Params = @{
+        CollectionUri = "https://dev.azure.com/contoso"
+        TeamId "564e8204-a90b-4432-883b-d4363c6125ca"
+    }
+    Get-AzDoTeam -CollectionUri = "https://dev.azure.com/contoso" -TeamId "564e8204-a90b-4432-883b-d4363c6125ca"
+
+    This example will fetch information about the team with the ID '564e8204-a90b-4432-883b-d4363c6125ca'.
+.OUTPUTS
+    PSObject with team(s).
+
+#>
+  [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Low')]
+  param (
+    # Collection Uri of the organization
+    [Parameter(Mandatory)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
+    [string]
+    $CollectionUri,
+
+    # Name of the project where the team is located
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [string]
+    $ProjectName,
+
+    # Name of the team to fetch
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [string[]]
+    $TeamName,
+
+    # Id of the team to fetch
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [string]
+    $TeamId
+  )
+
+  begin {
+    Write-Verbose "Starting function: Get-AzDoTeam"
+  }
+
+  process {
+    $params = @{
+      uri     = "$CollectionUri/_apis/teams"
+      version = "7.1-preview.3"
+      method  = 'GET'
+    }
+
+    if ($PSCmdlet.ShouldProcess($CollectionUri, "Get Teams from: $($PSStyle.Bold)$ProjectName$($PSStyle.Reset)")) {
+      $teams = (Invoke-AzDoRestMethod @params).value
+
+      # Filter the teams if the parameters are filled in
+      if ($TeamName) {
+        $teams = $teams | Where-Object { $_.name -eq $TeamName }
+      }
+      if ($ProjectName) {
+        $teams = $teams | Where-Object { $_.projectName -eq $ProjectName }
+      }
+      if ($TeamId) {
+        $teams = $teams | Where-Object { $_.id -eq $TeamId }
+      }
+      $result = $teams
+    } else {
+      Write-Verbose "Calling Invoke-AzDoRestMethod with $($params| ConvertTo-Json -Depth 10)"
+    }
+  }
+
+  end {
+    if ($result) {
+      $result | ForEach-Object {
+        [PSCustomObject]@{
+          CollectionURI = $CollectionUri
+          ProjectName   = $ProjectName
+          TeamName      = $_.name
+          TeamId        = $_.id
+        }
+      }
+    } else {
+      Write-Host "No teams found"
+    }
+  }
+}