Copy-TfsArea
Copies one or more Work Item Areas recursively
Table of Contents
Syntax
Copy-TfsArea
[-Node <object>]
[-Destination] <object>
[-Collection <object>]
[-DestinationProject <object>]
[-Force]
[-Project <object>]
[-Recurse]
[-Server <object>]
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 |
-Destination (Aliases: CopyTo)
Specifies the name and/or path of the destination parent node.
| Type | object |
| Position | 1 |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Specifies the name and/or path of the destination team project. When omitted, copies the area to the same team project.
| Type | object |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Allows the cmdlet to create destination parent node(s) if they’re missing.
| Type | SwitchParameter |
| Position | (Named) |
| Default Value | (N/A) |
| Accept pipeline input | False |
| Accept wildcard characters | False |
Specifies the name, URI or path of a Work Area. Wildcards are supported. When omitted, all Areas in the given Team Project are returned. To supply a path, use a backslash (‘') between the path segments. Leading and trailing backslashes are optional. When 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 | True (byvalue, bypropertyname) |
| 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 |
Copies nodes recursively. When omitted, sub-nodes are not copied.
| Type | SwitchParameter |
| 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 |
Inputs
System.Object
Specifies the name, URI or path of a Work Area. Wildcards are supported. When omitted, all Areas in the given Team Project are returned. To supply a path, use a backslash (‘') between the path segments. Leading and trailing backslashes are optional. When supplying a URI, use URIs in the form of ‘vstfs:///Classification/Node/{GUID}’ (where {GUID} is the unique identifier of the given node).