CodeIndex 명령CodeIndex Command

CodeIndex 명령을 사용하여 Team Foundation Server의 코드 인덱싱을 관리합니다.Use the CodeIndex command to manage code indexing on Team Foundation Server. 예를 들어 인덱싱을 다시 설정하여 CodeLens 정보를 수정하거나 인덱싱을 해제하여 서버 성능 문제를 조사할 수 있습니다.For example, you might want to reset the index to fix CodeLens information, or turn off indexing to investigate server performance issues.

필요한 권한Required Permissions

CodeIndex 명령을 사용하려면 Team Foundation Administrators 보안 그룹의 멤버여야 합니다.To use the CodeIndex command, you must be a member of the Team Foundation Administrators security group. Permissions and groups defined for Team Services and TFS(Team Services 및 TFS에 대해 정의된 권한 및 그룹)를 참조하세요.See Permissions and groups defined for Team Services and TFS.

참고

관리자 자격 증명으로 로그온한 경우에도 이 명령을 실행하려면 관리자 권한 명령 프롬프트 창을 열어야 합니다.Even if you log on with administrative credentials, you must open an elevated Command Prompt window to run this command. 또한 Team Foundation의 응용 프로그램 계층에서 이 명령을 실행해야 합니다.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 team project collection. 이름에 공백이 있으면 "Fabrikam 웹 사이트"와 같이 이름을 큰따옴표로 묶습니다.If the name has spaces, enclose the name with quotation marks, for example, "Fabrikam Web Site".
CollectionId 팀 프로젝트 컬렉션의 ID 번호를 지정합니다.Specifies the identification number of the team project collection.
ServerPath 코드 파일의 경로를 지정합니다.Specifies the path to a code file.
옵션Option 설명Description
/indexingStatus/indexingStatus 코드 인덱싱 서비스의 상태 및 구성을 보여 줍니다.Show the status and configuration of the code indexing service.
/setIndexing:[ on | off | keepupOnly ]/setIndexing:[ on | off | keepupOnly ] - on: 모든 변경 집합의 인덱싱을 시작합니다.- on: Start indexing all changesets.
- off: 모든 변경 집합의 인덱싱을 중지합니다.- off: Stop indexing all changesets.
- keepupOnly: 이전에 만든 변경 집합의 인덱싱을 중지하고 새 변경 집합의 인덱싱만 시작합니다.- keepupOnly: Stop indexing previously created changesets and start indexing new changesets only.
/ignoreList:[ add | remove | removeAll | view ] ServerPath/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: Add the file that you don't want indexed to the ignored file list.
- remove: 인덱싱할 파일을 무시된 파일 목록에서 제거합니다.- remove: Remove the file that you want indexed from the ignored file list.
- removeAll: 무시된 파일 목록을 지우고 모든 파일의 인덱싱을 시작합니다.- removeAll: Clear the ignored file list and start indexing all files.
- view: 인덱싱되고 있지 않는 모든 파일이 표시됩니다.- view: See all the files that aren't being indexed.
/listLargeFiles [/fileCount: FileCount /minSize: MinSize]/listLargeFiles [/fileCount: FileCount /minSize: MinSize] 지정된 크기(KB)를 초과하는 지정된 파일 수를 표시합니다.Shows the specified number of files that exceeds the specified size in KB. 그런 다음 /ignoreList 옵션을 사용하여 인덱싱에서 해당 파일을 제외할 수 있습니다.You can then use the /ignoreList option to exclude these files from indexing.
/reindexAll/reindexAll 이전에 인덱싱된 데이터를 지우고 인덱싱을 다시 시작합니다.Clear previously indexed data and restart indexing.
/destroyCodeIndex [/noPrompt]/destroyCodeIndex [/noPrompt] 코드 인덱스를 삭제하고 인덱싱된 모든 데이터를 제거합니다.Delete the code index and remove all indexed data. /noPrompt 옵션을 사용하는 경우 확인이 필요하지 않습니다.Does not require confirmation if you use the /noPrompt option.
/temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ]/temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] 변경 집합을 처리할 때 CodeLens에서 만드는 임시 데이터의 양을 제어합니다.Control how much temporary data that CodeLens creates when processing changesets. 기본 제한은 6GB입니다.The default limit is 2 GB.

- view: 현재 크기 제한을 표시합니다.- view: Show the current size limit.
- SizeInGBs: 크기 제한을 변경합니다.- SizeInGBs: Change the size limit.
- disable: 크기 제한을 제거합니다.- disable: Remove the size limit.

이 제한은 CodeLens가 새 변경 집합을 처리하기 전에 확인됩니다.This limit is checked before CodeLens processes a new changeset. 임시 데이터가 이 제한을 초과하면 CodeLens는 새 변경 집합이 아닌 이전 변경 집합 처리를 일시 중지합니다.If temporary data exceeds this limit, CodeLens will pause processing past changesets, not new ones. CodeLens는 데이터가 정리되고 이 제한 아래로 떨어진 후에 처리를 다시 시작합니다.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> ]/indexHistoryPeriod:[ view | all | <NumberOfMonths> ] 변경 내용을 인덱싱할 기간을 제어합니다.Control how long to index your change history. 이 옵션은 CodeLens에서 표시하는 기록의 양에 영향을 줍니다.This affects how much history CodeLens shows you. 기본 제한은 12개월입니다.The default limit is 12 months. 즉, CodeLens는 지난 12개월의 변경 내용만 표시합니다.This means CodeLens shows your change history from the last 12 months only.

- view: 현재 기간(월)을 표시합니다.- view: Show the current number of months.
- all: 모든 변경 내용을 인덱싱합니다.- all: Index all change history.
- NumberOfMonths: 변경 내용을 인덱싱하는 데 사용되는 기간(월)을 변경합니다.- NumberOfMonths: Change the number of months used to index change history.
/collectionName: CollectionName/collectionName: CollectionName CodeIndex 명령을 실행할 팀 프로젝트 컬렉션의 이름을 지정합니다.Specifies the name of the team project collection on which to run the CodeIndex command. /CollectionId를 사용하지 않는 경우 필수적 요소입니다.Required if you don't use /CollectionId.
/collectionId: CollectionId/collectionId: CollectionId CodeIndex 명령을 실행할 팀 프로젝트 컬렉션의 식별 번호를 지정합니다.Specifies the identification number of the team project collection on which to run the CodeIndex command. /CollectionName을 사용하지 않는 경우 필수적 요소입니다.Required if you don't use /CollectionName.

예제Examples

참고

용례에 사용된 회사, 기관, 제품, 도메인 이름, 메일 주소, 로고, 사람, 장소 및 이벤트는 실제 데이터가 아닙니다.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 Web Site"  

모든 변경 집합의 인덱싱을 시작하려면To start indexing all changesets:

TFSConfig CodeIndex /setIndexing:on /collectionName:"Fabrikam Web Site"  

이전에 만든 변경 집합의 인덱싱을 중지하고 새 변경 집합의 인덱싱만 시작하려면To stop indexing previously created changesets and start indexing new changesets only:

TFSConfig CodeIndex /setIndexing:keepupOnly /collectionName:"Fabrikam Web Site"  

10KB보다 큰 파일을 최대 50개 찾으려면:To find up to 50 files that are larger than 10 KB:

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

인덱싱에서 특정 파일을 제외하고 무시된 파일 목록에 추가하려면To exclude a specific file from indexing and add it to the ignored file list:

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

인덱싱되지 않는 모든 파일을 보려면: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 Web Site"  

모든 변경 집합 기록을 저장하려면To save all changeset history:

TFSConfig CodeIndex /indexHistoryPeriod:all /collectionName:"Fabrikam Web Site"  

CodeLens 임시 데이터에 대한 크기 제한을 제거하고 임시 데이터 크기에 관계 없이 인덱싱을 계속하려면To remove the size limit on CodeLens temporary data and continue indexing regardless of temporary data size:

TFSConfig CodeIndex /temporaryDataSizeLimit:disable /collectionName:"Fabrikam Web Site"  

확인 후 코드 인덱스를 삭제하려면To delete the code index with confirmation:

TFSConfig CodeIndex /destroyCodeIndex /collectionName:"Fabrikam Web Site"  

참고 항목See Also

CodeLens에서 코드 변경 내용 및 기타 기록 찾기Find code changes and other history with CodeLens

TFSConfig를 사용하여 서버 구성 관리 Managing server configuration with TFSConfig
TFS용 명령줄 도구Command-line tools for TFS