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

Back up and restore TFS

Other Resources

TFSConfig: Manage TFS server configuration

Move a team project collection

Split a team project collection