Link

Set-TfsTeam

Changes the details of a team.


Table of Contents

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

Syntax

Set team settings

Set-TfsTeam
    [-Team <object>]
    [-AreaPaths <string[]>]
    [-BacklogIteration <string>]
    [-BacklogVisibilities <Hashtable>]
    [-BugsBehavior <BugsBehavior>]
    [-Collection <object>]
    [-DefaultAreaPath <string>]
    [-DefaultIterationMacro <string>]
    [-Description <string>]
    [-Force]
    [-IterationPaths <string[]>]
    [-OverwriteAreaPaths]
    [-OverwriteIterationPaths]
    [-Passthru]
    [-Project <object>]
    [-Server <object>]
    [-WorkingDays <DayOfWeek[]>]

Set default team

Set-TfsTeam
    [-Team <object>]
    -Default
    [-Collection <object>]
    [-Passthru]
    [-Project <object>]
    [-Server <object>]

[Go to top]

Parameters

-AreaPaths

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

-BacklogIteration

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

-BacklogVisibilities

Specifies which backlog levels (e.g. Epics, Features, Stories) should be visible.

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

-BugsBehavior

Specifies how bugs should behave when added to a board. Possible values: Off, AsRequirements, AsTasks

Type BugsBehavior
Position (Named)
Default Value Off
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

-Default

Sets the specified team as the default team.

Type SwitchParameter
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.

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

-DefaultIterationMacro

Specifies the default iteration macro.

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

-Description

Specifies a new description

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

-Force

Allows the cmdlet to create target area and/or iteration nodes if they’re missing.

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

-IterationPaths

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

-OverwriteAreaPaths

Replaces the existing area paths with the specified list of area paths. When omitted, the new area paths are added alongside the previously defined ones.

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

-OverwriteIterationPaths

Replaces the existing iteration paths with the specified list of iteration paths. When omitted, the new iteration paths are added alongside the previously defined ones.

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

-Passthru

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

-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 False
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

-Team (Aliases: Name)

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

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

-WorkingDays

Specifies the team’s Working Days.

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

Inputs

System.Object

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

Outputs

Microsoft.TeamFoundation.Core.WebApi.WebApiTeam