Adds files and folders from a local file system to a server for Team Foundation version control.
The results of this command are not reflected in the server for Team Foundation version control until you perform a check-in operation. For more information, see Check In Pending Changes.
To use the add command, you must own the workspace and your Check out permission for the parent folder of the new items must be set to Allow. Your Lock permission must also be set to Allow if you use /lock:checkout or /lock:checkin. For more information, see Team Foundation Server Permissions.
tf add itemspec [/lock:(none|checkin|checkout)] [/type:filetype] [/noprompt] [/recursive] [/login:username,[password]]
Identifies the files or folders to add. For more information about how Team Foundation parses itemspecs to determine which items are within scope, see Command-Line Syntax (Version Control).
You can specify more than one Itemspec argument.
Used with the /type option. For more information, see Managing File Types.
Provides a value to the /login option. You can specify a username value as either Domain\UserName or UserName.
Overrides file type matching and adds files to the Team Foundation version control server that uses the specified type. For more information, see Managing File Types.
The file type detection is based on the contents of the first kilobyte of the file.
Specifies a lock type or removes a lock from an item.
Suppresses any prompts for input from you.
Adds all items in the specified directory and any subdirectories.
Specifies the user name and password to authenticate the user with Visual Studio Team Foundation Server.
Before you can add an item to version control, you must set up a local workspace and establish working folder mappings.
Add is a Pending Changes command; it schedules the items that you specify for addition to the Team Foundation version control server pending the completion of a check-in operation from your workspace. To perform a pending change command, your current directory must be mapped to a workspace and the Team Foundation version control server to which it corresponds.
When you use the Add command to add a new item to version control, the item is not actually added to the Team Foundation version control server until you check in your most recent workspace changes. Instead, the item is added to the list of pending changes for the current workspace. To commit the pending addition to the Team Foundation version control server, you can either check in the added file directly, or check in all pending changes in the local workspace. If you are concerned that another user might add a file or folder of the same name as one of your pending additions to the Team Foundation version control server before you have a chance to check in your pending changes, you can include the /lock option with the Checkout parameter to prevent them from doing this. For more information, see Check In Pending Changes.
If you add 314.cs to version control using tf add /teamproject/projects/math/314.cs, each of these folders is considered a pending addition if they do not already exist, until you check in your changes. When you check in the changes, if any of the folders in the specified path (/teamproject, /teamproject/projects, or /teamproject/projects/math) do not already exist in the Team Foundation version control server, Team Foundation creates them for you.
You can use the Add command to establish the initial file structure of a Team Foundation version control server.
For more information on how to find the tf command-line utility, see Tf Command-Line Utility Commands.
The following example adds the files, 314.c and 1256.c to the list of pending changes for the workspace with which the working folder C:\Pi is associated.
c:\pi>tf add 314.cs 1256.c
The following example adds all C# code files (.cs) in the current directory and any subdirectories to the list of pending additions for the current workspace.
c:\projects>tf add *.cs /recursive
The following example adds all files and folders whose names contain "hello" in the current directory and all its subfolders to the list of pending additions for the workspace to which c:\projects maps.
c:\projects>tf add *hello* /recursive