Jobs Command
You can use the Jobs command to create a log file that provides the details of the most recent job activity for a specific team project collection. Jobs are run at any time when an update is required to change the information or configuration for a collection. You can also use this command to retry a job for one or all team project collections.
To retry a job interactively, you can open the administration console for Team Foundation, click the Status tab for the collection, and then click Retry Job. For more information, see Open the Team Foundation Administration Console.
Required Permissions
To use the Jobs command, you must be a member of the Team Foundation Administrators security group. For more information, see Permission reference for Team Foundation Server.
Note
Even if you log on with administrative credentials, you must open an elevated Command Prompt window to perform this function.
TFSConfig Jobs /retry [/CollectionName:CollectionName] [/CollectionID:ID]
TFSConfig Jobs /dumplog [/CollectionName:CollectionName] [/CollectionID:ID]
Parameters
Placeholder |
Description |
|---|---|
CollectionName |
Specifies the name of the team project collection. If the name of the collection contains spaces, you must enclose the name with quotation marks (for example, "My Collection") If you want to specify all collections, you can use an asterisk (*). |
ID |
Specifies the identification number of the team project collection. |
Option |
Description |
|---|---|
/retry |
Required if /dumplog is not used. Specifies that the most recent job will be reattempted for the specified team project collection. If you use this option, you must also use either the /CollectionName or the /CollectionID option. |
/dumplog |
Required if /retry is not used. Specifies that the most recent job activity for the collection will be sent to a log file. If you use this option, you must also use either the /CollectionName or /CollectionID option. |
/CollectionName:CollectionName |
Required if /CollectionID is not used. Specifies the name of the collection for which the most recent job will be either retried (/retry) or logged (/dumplog). If you want to specify all collections, you can use an asterisk (*). |
/CollectionID:ID |
Required if /CollectionName is not used. Specifies the identification number of the collection for which the most recent job will be either retried (/retry) or logged (/dumplog). |
Example
The following example shows how to create a log file that lists the most recent job activity for the "Contoso Summer Intern Projects" team project collection in Team Foundation Server.
Note
The examples are for illustration only and are fictitious. No real association is intended or inferred.
TFSConfig Jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"
See Also
Concepts
Other Resources
TFSConfig: Manage TFS server configuration