Link

Get-TfsIteration

Gets one or more Iterations from a given Team Project.


Table of Contents

  1. Syntax
  2. Examples
  3. Parameters
  4. Inputs
  5. Outputs
  6. Related Links

Syntax

Get-TfsIteration
    [-Node <object>]
    [-Collection <object>]
    [-Project <object>]
    [-Server <object>]

[Go to top]

Examples

Example 1

Returns all iterations in the currently connected Team Project (as defined by a previous call to Connect-TfsTeamProject)

PS> Get-TfsIteration

Example 2

Performs a recursive search and returns all iterations named ‘Support’ that may exist in a team project called Tailspin

PS> Get-TfsIteration '\**\Support' -Project Tailspin

Parameters

-Collection (Aliases: Organization)

Specifies the URL to the Team Project Collection or Azure DevOps Organization to connect to, a TfsTeamProjectCollection object (Windows PowerShell only), or a VssConnection object. You can also connect to an Azure DevOps Services organizations by simply providing its name instead of the full URL. For more details, see the Get-TfsTeamProjectCollection cmdlet. When omitted, it defaults to the connection set by Connect-TfsTeamProjectCollection (if any).

Type object
Position (Named)
Default Value (N/A)
Accept pipeline input False
Accept wildcard characters False

-Node (Aliases: Path, Iteration)

Specifies the name, URI or path of an Iteration. Wildcards are supported. When omitted, all Iterations in the given Team Project are returned.nnTo supply a path, use a backslash (‘') between the path segments. Leading and trailing backslashes are optional.nnWhen supplying a URI, use URIs in the form of ‘vstfs:///Classification/Node/{GUID}’ (where {GUID} is the unique identifier of the given node).

Type object
Position 0
Default Value **
Accept pipeline input False
Accept wildcard characters False

-Project

Specifies the name of the Team Project, its ID (a GUID), or a Microsoft.TeamFoundation.Core.WebApi.TeamProject object to connect to. When omitted, it defaults to the connection set by Connect-TfsTeamProject (if any). For more details, see the Get-TfsTeamProject cmdlet.

Type object
Position (Named)
Default Value (N/A)
Accept pipeline input True (byvalue)
Accept wildcard characters False

-Server

Specifies the URL to the Team Foundation Server to connect to, a TfsConfigurationServer object (Windows PowerShell only), or a VssConnection object. When omitted, it defaults to the connection set by Connect-TfsConfiguration (if any). For more details, see the Get-TfsConfigurationServer cmdlet.

Type object
Position (Named)
Default Value (N/A)
Accept pipeline input False
Accept wildcard characters False

Inputs

System.Object

Specifies the name of the Team Project, its ID (a GUID), or a Microsoft.TeamFoundation.Core.WebApi.TeamProject object to connect to. When omitted, it defaults to the connection set by Connect-TfsTeamProject (if any). For more details, see the Get-TfsTeamProject cmdlet.

Outputs

TfsCmdlets.Models.ClassificationNode