New-TfsTeam
Creates a new team.
Table of Contents
Syntax
Set team settings
New-TfsTeam
[-Team] <string>
[-AreaPaths <string[]>]
[-BacklogIteration <string>]
[-Collection <object>]
[-DefaultAreaPath <string>]
[-DefaultIterationMacro <string>]
[-Description <string>]
[-IterationPaths <string[]>]
[-NoBacklogIteration]
[-NoDefaultArea]
[-Passthru]
[-Project <object>]
[-Server <object>]
Parameters
Specifies the backlog area path(s) that are associated with this team. Wildcards are supported. When the path ends with an asterisk, all child area paths will be included recursively. Otherwise, only the area itself (without its children) will be included. To include the children of the default area path, use the wildcard character (*) without a path.
| Type | string[] |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Specifies the team’s backlog iteration path. When omitted, defaults to the team project’s root iteration.
| Type | string |
| Position | (Named) |
| Default Value | \ |
| Accept pipeline input | False |
| Accept wildcard characters | False |
-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 |
-DefaultAreaPath (Aliases: TeamFieldValue)
Specifies the team’s default area path (or “team field”). The default area path is assigned automatically to all work items created in a team’s backlog and/or board. When omitted, an area path may still be associated to this team depending on whether NoAutomaticAreaPath is set
| Type | string |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Specifies the default iteration macro. When omitted, defaults to “@CurrentIteration”.
| Type | string |
| Position | (Named) |
| Default Value | @CurrentIteration |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Specifies a description of the new team.
| Type | string |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Specifies the backlog iteration path(s) that are associated with this team. Wildcards are supported.
| Type | string[] |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Do not associate an iteration path automatically to the new team. When omitted, an iteration path is created (if needed) and then is set as the default backlog iteration
| Type | SwitchParameter |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Do not associate an area path automatically to the new team. When omitted, an area path is created (if needed) and then is set as the default area path / team field
| Type | SwitchParameter |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Returns the results of the command. By default, this cmdlet does not generate any output.
| Type | SwitchParameter |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
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 | False |
| Accept wildcard characters | False |
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 |
Specifies the name of the new team.
| Type | string |
| Position | 0 |
| Default Value | (N/A) |
| Accept pipeline input | True (byvalue) |
| Accept wildcard characters | False |
Inputs
System.String
Specifies the name of the new team.