Getcs Command
You can use the getcs command to get only the files in a specified changeset at the version that was submitted in that changeset.
Required Permissions
To use this command, the Read permission on the files that you are trying to get must be set to Allow. For more information, see the following topic on the Microsoft Web site: Team Foundation Server Permissions.
tf getcs -changeset:ChangesetNumber [/latest]
Parameters
Argument |
Description |
|---|---|
ChangesetNumber |
Provides a value such as C3 for the -version option. For more information about how the Cross-platform Command-Line Client for Team Foundation Server parses a version specification to determine which items are within its scope, see Command-line Syntax (Team Explorer Everywhere). |
Option |
Description |
|---|---|
-changeset |
Specifies the number of the changeset that you want to get. |
-latest |
Specifies that you want to retrieve the latest Team Foundation version control versions of the files in the specified changeset instead of the versions that were submitted in the changeset. |
Remarks
You can use the history command to find the changeset that you want to retrieve. For more information, see the following page on the Microsoft Web site: History Command (Team Foundation Version Control).
Only files in folders that are mapped to working folders are retrieved.
The getcs command does not retrieve files into your workspace or check them out. For more information about how to get the Team Foundation version control server version and how to check out files, see the following pages on the Microsoft Web site: Get Command (Team Foundation Version Control) and Checkout and Edit Commands (Team Foundation Version Control).
For more information about how you can view the differences between two versions of a file, see the following page on the Microsoft Web site: Difference Command (Team Foundation Version Control).
Examples
The following example gets the version of the files that were submitted in changeset 1999.
tf getcs -changeset:C1999
The following example gets the latest versions of the files that were submitted in changeset 1999.
tf getcs -changeset:C1999 -latest