Agent Pools cmdlets for removing, adding and updating

.docs/Add-VSTeamPool.md

@@ -0,0 +1,86 @@
+<!-- #include "./common/header.md" -->
+
+# Add-VSTeamPool
+
+## SYNOPSIS
+
+<!-- #include "./synopsis/Add-VSTeamPool.md" -->
+
+## SYNTAX
+
+## DESCRIPTION
+
+<!-- #include "./synopsis/Add-VSTeamPool.md" -->
+
+## EXAMPLES
+
+### Example 1
+
+```powershell
+Add-VSTeamPool -Name "TestPool" -Description "Test Description" -AutoProvision -AutoAuthorize -NoAutoUpdates
+```
+
+It's creating an agent pool with the name "TestPool" that is auto provisioning to every project and also pre-authorized to be used with every pipeline. Agent software is not updated automatically.
+
+## PARAMETERS
+
+### -Name
+
+Name of the pool to create.
+
+```yaml
+Type: string
+Required: True
+```
+
+### -Description
+
+Description of the pool to create.
+
+```yaml
+Type: string
+Required: False
+```
+
+### -AutoProvision
+
+Auto-provision this agent pool in new projects.
+
+```yaml
+Type: string
+Required: True
+```
+
+### -AutoAuthorize
+
+Grant access permission to all pipelines.
+
+```yaml
+Type: string
+Required: True
+```
+
+### -NoAutoUpdates
+
+Turn off automatic updates of agents in the pool. Default is turned on.
+
+```yaml
+Type: string
+Required: True
+```
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Object
+
+## NOTES
+
+## RELATED LINKS
+
+[Remove-VSTeamPool](Remove-VSTeamPool.md)
+[Update-VSTeamPool](Update-VSTeamPool.md)
+[Get-VSTeamPool](Get-VSTeamPool.md)
+
+<!-- #include "./common/related.md" -->

.docs/Get-VSTeamPool.md

@@ -42,4 +42,8 @@ Accept pipeline input: true (ByPropertyName)
 
 ## RELATED LINKS
 
-<!-- #include "./common/related.md" -->
+[Remove-VSTeamAccount](Remove-VSTeamAccount.md)
+[Update-VSTeamAccount](Update-VSTeamAccount.md)
+[Add-VSTeamAccount](Add-VSTeamAccount.md)
+
+<!-- #include "./common/related.md" -->

.docs/Remove-VSTeamPool.md

@@ -0,0 +1,44 @@
+<!-- #include "./common/header.md" -->
+
+# Remove-VSTeamPool
+
+## SYNOPSIS
+
+<!-- #include "./synopsis/Remove-VSTeamPool.md" -->
+
+## SYNTAX
+
+## DESCRIPTION
+
+<!-- #include "./synopsis/Remove-VSTeamPool.md" -->
+
+## EXAMPLES
+
+## PARAMETERS
+
+### -Id
+
+Id of the pool to delete.
+
+```yaml
+Type: int
+Parameter Sets: ByID
+Aliases: PoolID
+Required: True
+Accept pipeline input: true (ByPropertyName)
+```
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+
+## RELATED LINKS
+
+[Add-VSTeamPool](Add-VSTeamPool.md)
+[Update-VSTeamPool](Update-VSTeamPool.md)
+[Get-VSTeamPool](Get-VSTeamPool.md)
+
+
+<!-- #include "./common/related.md" -->

.docs/Update-VSTeamPool.md

@@ -0,0 +1,90 @@
+<!-- #include "./common/header.md" -->
+
+# Update-VSTeamPool
+
+## SYNOPSIS
+
+<!-- #include "./synopsis/Update-VSTeamPool.md" -->
+
+## SYNTAX
+
+## DESCRIPTION
+
+<!-- #include "./synopsis/Update-VSTeamPool.md" -->
+
+## EXAMPLES
+
+### Example 1
+
+```powershell
+Update-VSTeamPool -Id 13 -Name "UpdatedTestPoolName" -Description "Test Description" -AutoProvision -NoAutoUpdates
+```
+Updates the pool with id 13 with the name new "UpdatedTestPoolName" that is auto-provisioning to every project and agent software is not updating automatically.
+
+## PARAMETERS
+
+### -Id
+
+Id of the pool to return.
+
+```yaml
+Type: int
+Parameter Sets: ByID
+Aliases: PoolID
+Required: True
+Accept pipeline input: true (ByPropertyName)
+```
+
+### -Name
+
+Name of the pool to update.
+
+```yaml
+Type: string
+Required: True
+```
+
+### -Description
+
+Description of the pool to update.
+
+```yaml
+Type: string
+Required: False
+```
+
+### -AutoProvision
+
+Auto-provision this agent pool in new projects.
+
+```yaml
+Type: string
+Required: True
+```
+
+### -NoAutoUpdates
+
+Turn off automatic updates of agents in the pool. Default is turned on.
+
+```yaml
+Type: string
+Required: True
+```
+
+## INPUTS
+
+### System.String
+
+## OUTPUTS
+
+### System.Object
+
+## NOTES
+
+## RELATED LINKS
+
+[Remove-VSTeamPool](Remove-VSTeamPool.md)
+[Add-VSTeamPool](Add-VSTeamPool.md)
+[Get-VSTeamPool](Get-VSTeamPool.md)
+
+<!-- #include "./common/related.md" -->

.docs/synopsis/Add-VSTeamPool.md

@@ -0,0 +1 @@
+Adds a new agent pool.

.docs/synopsis/Remove-VSTeamPool.md

@@ -0,0 +1 @@
+Removes the agent pool.

.docs/synopsis/Update-VSTeamPool.md

@@ -0,0 +1 @@
+Updates an agent pool.

.vscode/settings.json

@@ -56,5 +56,6 @@
    ],
    "powershell.pester.useLegacyCodeLens": false,
    "powershell.pester.outputVerbosity": "Detailed",
-   "powershell.codeFormatting.addWhitespaceAroundPipe": true
+   "powershell.codeFormatting.addWhitespaceAroundPipe": true,
+   "gitdoc.enabled": false
 }

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 7.3.0
+
+Merged [Pull Request](https://github.com/DarqueWarrior/vsteam/pull/384) from [Sebastian Schütze](https://github.com/SebastianSchuetze) which included the following:
+
+- Add-VSTeamPool, Remove-VSTeamPool and Update-VSTeampool for handling agent pools on Azure DevOps
+
 ## 7.2.0
 
 Merged [Pull Request](https://github.com/DarqueWarrior/vsteam/pull/371) and (https://github.com/DarqueWarrior/vsteam/pull/389) from [Sebastian Schütze](https://github.com/SebastianSchuetze) which included the following:
@@ -25,6 +31,7 @@ Merged [Pull Request](https://github.com/DarqueWarrior/vsteam/pull/350) from [Da
 
 Also added Clear-VSTeamDefaultProjectCount and Set-VSTeamDefaultProjectCount to control the default number of projects returned for tab completion and validation. By default only 100 projects are returned and the 100 returned is nondeterministic. But calling Set-VSTeamDefaultProjectCount you can increase the number of projects returned.
 
+
 ## 7.1.2
 
 Merged [Pull Request](https://github.com/DarqueWarrior/vsteam/pull/366) from [Jhoneill](https://github.com/jhoneill) which included the following:

Source/Classes/Attribute/TimeZonesValidateAttribute.cs

@@ -0,0 +1,10 @@
+using System.Collections.Generic;
+
+namespace vsteam_lib
+{
+   public class TimeZoneValidateAttribute : BaseValidateArgumentsAttribute
+   {
+      internal override IEnumerable<string> GetValues() => TimeZones.GetTimeZoneIds();
+   }
+
+}

Source/Classes/Completer/BaseCompleter.cs

@@ -11,40 +11,71 @@
 
 namespace vsteam_lib
 {
-   public abstract class BaseCompleter : IArgumentCompleter
-   {
-      protected readonly IPowerShell _powerShell;
-
-      /// <summary>
-      /// This constructor is used during unit testings
-      /// </summary>
-      /// <param name="powerShell">fake instance of IPowerShell used for testing</param>
-      protected BaseCompleter(IPowerShell powerShell) { this._powerShell = powerShell; }
-
-      /// <summary>
-      /// This constructor is used when running in a PowerShell session. It cannot be
-      /// loaded in a unit test.
-      /// </summary>
-      [ExcludeFromCodeCoverage]
-      protected BaseCompleter() : this(new PowerShellWrapper(RunspaceMode.CurrentRunspace)) { }
-
-      public abstract IEnumerable<CompletionResult> CompleteArgument(string commandName,
-                                                                     string parameterName,
-                                                                     string wordToComplete,
-                                                                     CommandAst commandAst,
-                                                                     IDictionary fakeBoundParameters);
-
-      protected static void SelectValues(string wordToComplete, IEnumerable<string> words, List<CompletionResult> values)
-      {
-         foreach (var word in words)
-         {
-            if (string.IsNullOrEmpty(wordToComplete) || word.StartsWith(wordToComplete, true, CultureInfo.InvariantCulture))
+    public abstract class BaseCompleter : IArgumentCompleter
+    {
+        protected readonly IPowerShell _powerShell;
+
+        /// <summary>
+        /// This constructor is used during unit testings
+        /// </summary>
+        /// <param name="powerShell">fake instance of IPowerShell used for testing</param>
+        protected BaseCompleter(IPowerShell powerShell) { this._powerShell = powerShell; }
+
+        /// <summary>
+        /// This constructor is used when running in a PowerShell session. It cannot be
+        /// loaded in a unit test.
+        /// </summary>
+        [ExcludeFromCodeCoverage]
+        protected BaseCompleter() : this(new PowerShellWrapper(RunspaceMode.CurrentRunspace)) { }
+
+        public abstract IEnumerable<CompletionResult> CompleteArgument(string commandName,
+                                                                       string parameterName,
+                                                                       string wordToComplete,
+                                                                       CommandAst commandAst,
+                                                                       IDictionary fakeBoundParameters);
+
+        protected static void SelectValues(string wordToComplete, IEnumerable<string> words, List<CompletionResult> values)
+        {
+            foreach (var word in words)
+            {
+                if (string.IsNullOrEmpty(wordToComplete) || word.StartsWith(wordToComplete, true, CultureInfo.InvariantCulture))
+                {
+                    values.Add(GetCompletionResult(word));
+                }
+            }
+        }
+
+
+        private static CompletionResult GetCompletionResult(string word)
+        {
+            return GetCompletionResult(word,word,CompletionResultType.Text);
+        }
+
+        private static CompletionResult GetCompletionResult(string word, string wordLabel, CompletionResultType resultType)
+        {
+            // Only wrap in single quotes if they have a space. This makes it easier
+            // to use on macOs
+            return (new CompletionResult(word.Contains(" ") ? $"'{word}'" : word, wordLabel, resultType, wordLabel + ": " + word));
+
+        }
+
+        protected static void SelectValues(string wordToComplete,
+                                            Dictionary<string, string> words,
+                                            List<CompletionResult> values)
+        {
+            foreach (var word in words)
             {
-               // Only wrap in single quotes if they have a space. This makes it easier
-               // to use on macOs
-               values.Add(new CompletionResult(word.Contains(" ") ? $"'{word}'" : word));
+                var keyToSearch = word.Key.ToLower();
+                var valueToSearch = word.Value.ToLower();
+
+                if (string.IsNullOrEmpty(wordToComplete) ||
+                    keyToSearch.Contains(wordToComplete) ||
+                    valueToSearch.Contains(wordToComplete)
+                    )
+                {
+                    values.Add(GetCompletionResult(word.Key, word.Value, CompletionResultType.Text));
+                }
             }
-         }
-      }
-   }
+        }
+    }
 }