Add command (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013
The add command adds files and folders to a TFVC repository.
Tip
Before you add files to version control, you should first set up the workspace on your dev machine. See Workspace Command or Set up Team Foundation Version Control on your dev machine.
Prerequisites
Syntax
tf add itemspec [/lock:(none|checkin|checkout)] [/encoding:filetype]
[/noprompt] [/recursive] [/noignore] [/login:username,[password]]
Parameters
| Parameter | Description |
|---|---|
| /encoding: filetype | Ignore this parameter. |
| itemspec | Specifies the scope of the items to add. You can specify more than one itemspec argument. |
| /lock | Applies or removes a lock. See Use Team Foundation version control commands. |
| /login:username,[password] | Specifies the user account to run the command. See Use Team Foundation version control commands. |
| /noignore | By default certain types of files (for example, .dll files) are ignored by version control. The rules in a .tfignore files apply to the Add command when you specify a wildcard in your itemspec. To override the application of the rules in this case, specify /noignore. You can configure which kinds of files are ignored using a .tfignore file (see Add Files: .tfignore file). |
| /noprompt | Suppresses the display of windows and dialog boxes and redirects output data to the command prompt. See Use Team Foundation version control commands. |
| /recursive | Recursively adds items in the specified directory and any subdirectories. |
Examples
In all the following examples, assume that $/SiteApp/Main/ is mapped to c:\\code\\SiteApp\\Main\\ in the workspace.
Add all new files in a local workspace
New files in a local workspace are automatically detected. You can promote these newly detected files to your pending changes.
c:\code\SiteApp\Main\SolutionA\Project1>tf add
Adds the latest versions of all items, except those items that are ignored, in a local workspace.
c:\code\SiteApp\Main\SolutionA\Project1>tf add /noignore
Adds the latest versions of all items in a local workspace.
Add individual items
c:\code\SiteApp\Main>tf add program1.cs program2.cs
Adds the files program1.cs and program2.cs.
Recursively add all items of a specific type
c:\code\SiteApp\Main>tf add *.cs /recursive
Adds all C# code files (.cs) in the current directory and any subdirectories.
Work in Visual Studio
- Add files to the server Use Visual Studio to add files to the server.
Tips
- The results of the add command are queued as pending changes and don't take effect on the server until you check in. See Checkin command.
- If you need to set aside changes or want to clean your workspace for another task, use the Shelve command.