Update readme

Author: nyanhp

AutomatedLab.Common/TeamFoundation/Public/Get-TfsAgentPool.ps1

@@ -6,6 +6,14 @@ function Get-TfsAgentPool
         [string]
         $InstanceName,
 
+        [Parameter()]
+        [string]
+        $CollectionName = 'DefaultCollection',
+
+        [Parameter()]
+        [string]
+        $PoolName = '*',
+
         [ValidateRange(1, 65535)]
         [uint32]
         $Port,
@@ -28,11 +36,11 @@ function Get-TfsAgentPool
     $requestUrl = if ($UseSsl) {'https://' } else {'http://'}
     $requestUrl += if ( $Port  -gt 0)
     {
-        '{0}{1}/_apis/distributedtask/pools' -f $InstanceName, ":$Port"
+        '{0}{1}/{2}/_apis/distributedtask/pools' -f $InstanceName, ":$Port", $CollectionName
     }
     else
     {
-        '{0}/_apis/distributedtask/pools' -f $InstanceName
+        '{0}/{1}/_apis/distributedtask/pools' -f $InstanceName, $CollectionName
     }
 
     if ($ApiVersion)
@@ -67,10 +75,10 @@ function Get-TfsAgentPool
 
     if ($result.value)
     {
-        return $result.value
+        return $result.value | Where-Object -Property Name -like $PoolName
     }
     elseif ($result)
     {
-        return $result
+        return $result | Where-Object -Property Name -like $PoolName
     }
 }

README.md

@@ -72,3 +72,25 @@ Our PKI cmdlets make configurations, certificate requests and duplicating templa
 - Publish-CaTemplate: Publish a template
 - Request-Certificate: Request a new certificate from the CA
 - Test-CaTemplate: Uses certutil to check if a template exists
+
+## CI/CD (Team Foundation Server, Azure DevOps (Server))
+
+Our CI/CD cmdlets make interaction with Team Foundation Server starting with 2015 a breeze. Just be sure
+to select the API version matching your edition of TFS or Azure DevOps.
+
+- Get-TfsAccessTokenString: Get the Authorization header string for your PAT
+- Get-TfsAgentPool: Retrieve TFS/Azure DevOps agent pools for an instance
+- Get-TfsAgentQueue: Retrieve a TFS/Azure DevOps Project's agent queue
+- Get-TfsBuildDefinition: Retrieve a build definition
+- Get-TfsBuildDefinitionTemplate: Retrieve the available build templates of a project
+- Get-TfsBuildStep: List all possible build steps to use in a build definition
+- Get-TfsGitRepository: Get the GIT repo of a project
+- Get-TfsProcessTemplate: Get all possible process templates
+- Get-TfsProject: Get a list of Projects or an individual project
+- Get-TfsReleaseDefinition: Retrieve a release definition
+- Get-TfsReleaseStep: Get a list of possible release steps
+- New-TfsAgentQueue: Create a new agent queue from a pool of agents
+- New-TfsBuildDefinition: Create a new build pipeline
+- New-TfsProject: Create a new team project
+- New-TfsReleaseDefinition: Create a new release pipeline
+- Set-TfsProject: Modify a project configuration