Compartilhar via


CodeIndex command

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Use the CodeIndex command to manage code indexing on Team Foundation Server. For example, you might want to reset the index to fix CodeLens information, or turn off indexing to investigate server performance issues.

Required permissions

To use the CodeIndex command, you must be a member of the Team Foundation Administrators security group. See Permissions and groups defined for Azure DevOps Services and TFS.

Note

Even if you log on with administrative credentials, you must open an elevated Command Prompt window to run this command. You must also run this command from the application tier for Team Foundation.

Syntax

TFSConfig CodeIndex /indexingStatus | /setIndexing:[ on | off | keepupOnly ] | /ignoreList:[ add | remove | removeAll | view ] ServerPath | /listLargeFiles [/fileCount:FileCount] [/minSize:MinSize] | /reindexAll | /destroyCodeIndex [/noPrompt] | /temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] | /indexHistoryPeriod:[ view | all | <NumberOfMonths> ] [/collectionName:CollectionName | /collectionId:CollectionId]

Parameters

Argument Description
CollectionName Specifies the name of the project collection. If the name has spaces, enclose the name with quotation marks, for example, "Fabrikam Website".
CollectionId Specifies the identification number of the project collection.
ServerPath Specifies the path to a code file.
Option Description
/indexingStatus Show the status and configuration of the code indexing service.
/setIndexing:[ on | off | keepupOnly ] - on: Start indexing all changesets.
- off: Stop indexing all changesets.
- keepupOnly: Stop indexing previously created changesets and start indexing new changesets only.
/ignoreList:[ add | remove | removeAll | view ] ServerPath

You can use the wildcard character (*) at the start, end, or both ends of the server path.
Specifies a list of code files and their paths that you don't want indexed.

- add: Add the file that you don't want indexed to the ignored file list.
- remove: Remove the file that you want indexed from the ignored file list.
- removeAll: Clear the ignored file list and start indexing all files.
- view: See all the files that aren't being indexed.
/listLargeFiles [/fileCount: FileCount /minSize: MinSize] Shows the specified number of files that exceeds the specified size in KB. You can then use the /ignoreList option to exclude these files from indexing.
/reindexAll Clear previously indexed data and restart indexing.
/destroyCodeIndex [/noPrompt] Delete the code index and remove all indexed data. Does not require confirmation if you use the /noPrompt option.
/temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] Control how much temporary data that CodeLens creates when processing changesets. The default limit is 2 GB.

- view: Show the current size limit.
- SizeInGBs: Change the size limit.
- disable: Remove the size limit.

This limit is checked before CodeLens processes a new changeset. If temporary data exceeds this limit, CodeLens will pause processing past changesets, not new ones. CodeLens will restart processing after the data is cleaned up and falls below this limit. Cleanup runs automatically once a day. This means temporary data might exceed this limit until cleanup starts running.
/indexHistoryPeriod:[ view | all | <NumberOfMonths> ] Control how long to index your change history. This affects how much history CodeLens shows you. The default limit is 12 months. This means CodeLens shows your change history from the last 12 months only.

- view: Show the current number of months.
- all: Index all change history.
- NumberOfMonths: Change the number of months used to index change history.
/collectionName: CollectionName Specifies the name of the project collection on which to run the CodeIndex command. Required if you don't use /CollectionId.
/collectionId: CollectionId Specifies the identification number of the project collection on which to run the CodeIndex command. Required if you don't use /CollectionName.

Examples

Note

The example companies, organizations, products, domain names, email 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.

To see the code indexing status and configuration:

TFSConfig CodeIndex /indexingStatus /collectionName:"Fabrikam Website"

To start indexing all changesets:

TFSConfig CodeIndex /setIndexing:on /collectionName:"Fabrikam Website"

To stop indexing previously created changesets and start indexing new changesets only:

TFSConfig CodeIndex /setIndexing:keepupOnly /collectionName:"Fabrikam Website"

To find up to 50 files that are larger than 10 KB:

TFSConfig CodeIndex /listLargeFiles /fileCount:50 /minSize:10 /collectionName:"Fabrikam Website"

To exclude a specific file from indexing and add it to the ignored file list:

TFSConfig CodeIndex /ignoreList:add "$/Fabrikam Website/Catalog.cs" /collectionName:"Fabrikam Website"

To see all the files that aren't indexed:

TFSConfig CodeIndex /ignoreList:view

To clear previously indexed data and restart indexing:

TFSConfig CodeIndex /reindexAll /collectionName:"Fabrikam Website"

To save all changeset history:

TFSConfig CodeIndex /indexHistoryPeriod:all /collectionName:"Fabrikam Website"

To remove the size limit on CodeLens temporary data and continue indexing regardless of temporary data size:

TFSConfig CodeIndex /temporaryDataSizeLimit:disable /collectionName:"Fabrikam Website"

To delete the code index with confirmation:

TFSConfig CodeIndex /destroyCodeIndex /collectionName:"Fabrikam Website"

See also