Added Update-VSTeamAgent to update agent version

.docs/Update-VSTeamAgent.md

@@ -0,0 +1,48 @@
+<!-- #include "./common/header.md" -->
+
+# Update-VSTeamAgent
+
+## SYNOPSIS
+
+<!-- #include "./synopsis/Update-VSTeamAgent.md" -->
+
+## SYNTAX
+
+## DESCRIPTION
+
+<!-- #include "./synopsis/Update-VSTeamAgent.md" -->
+
+## EXAMPLES
+
+## PARAMETERS
+
+### -PoolId
+
+Id of the pool.
+
+```yaml
+Type: int
+Required: True
+Accept pipeline input: true (ByValue)
+```
+
+### -Id
+
+Id of the agent to Update.
+
+```yaml
+Type: int[]
+Aliases: AgentID
+Required: True
+Accept pipeline input: true (ByPropertyName)
+```
+
+## INPUTS
+
+### System.String
+
+## OUTPUTS
+
+## NOTES
+
+## RELATED LINKS

.docs/synopsis/Update-VSTeamAgent.md

@@ -0,0 +1 @@
+Update an agent in a pool.

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 6.4.5
+
+Merged [Pull Request](https://github.com/DarqueWarrior/vsteam/pull/273) from [Lukas Wöhrl](https://github.com/woehrl01) which included the following:
+
+Adds a new function Update-VSTeamAgent which allows to update the agent version
+
 ## 6.4.4
 
 Merged [Pull Request](https://github.com/DarqueWarrior/vsteam/pull/257) from [Michel Zehnder](https://github.com/MichelZ) which included the following:

Source/Public/Update-VSTeamAgent.ps1

@@ -0,0 +1,22 @@
+function Update-VSTeamAgent {
+   param(
+      [Parameter(Mandatory = $true, ValueFromPipeline = $true, Position = 0)]
+      [int] $PoolId,
+
+      [parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 1)]
+      [Alias('AgentID')]
+      [int[]] $Id
+   )
+
+   process {
+      foreach ($item in $Id) {
+         try {
+            _callAPI -Method Post -Area "distributedtask/pools/$PoolId" -Resource messages -QueryString @{agentId=$item} -Version $([VSTeamVersions]::DistributedTask) -ContentType "application/json" | Out-Null
+            Write-Output "Update agent $item"
+         }
+         catch {
+            _handleException $_
+         }
+      }
+   }
+}

unit/test/agents.Tests.ps1

@@ -130,5 +130,28 @@ InModuleScope VSTeam {
             { Disable-VSTeamAgent -Pool 36 -Id 950 } | Should Throw
          }
       }
+
+      Context 'Update-VSTeamAgent by ID' {
+         Mock Invoke-RestMethod
+
+         It 'should update the agent with passed in Id' {
+            Update-VSTeamAgent -Pool 36 -Id 950
+
+            Assert-MockCalled Invoke-RestMethod -Exactly -Scope It -Times 1 -ParameterFilter {
+               $Method -eq 'Post' -and
+               $Uri -like "*https://dev.azure.com/test/_apis/distributedtask/pools/36/messages*" -and
+               $Uri -like "*api-version=$([VSTeamVersions]::DistributedTask)*" -and
+               $Uri -like "*agentId=950*"
+            }
+         }
+      }
+
+      Context 'Update-VSTeamAgent throws' {
+         Mock Invoke-RestMethod { throw 'boom' }
+
+         It 'should update the agent with passed in Id' {
+            { Update-VSTeamAgent -Pool 36 -Id 950 } | Should Throw
+         }
+      }
    }
 }