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 Team Foundation Server Permissions.
Note
Even if you log on with administrative credentials, you must open an elevated Command Prompt window to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt window, click Start, right-click Command Prompt, and then click Run as Administrator. For more information, see this page on the Microsoft Web site: User Account Control.
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 example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, places, or events is intended or should be inferred.
TFSConfig Jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"
See Also
Tasks
Move a Team Project Collection
Split a Team Project Collection
Concepts
Backing up and Restoring Your Deployment