RenameDT 명령

아티클
08/20/2008

업데이트: 2007년 11월

RenameDT를 사용하여 Team Foundation Server 데이터 계층 서버 이름을 변경할 수 있습니다.

중요:
RenameDT 명령을 성공적으로 실행하려면 다음 응용 프로그램 풀 및 프로그램을 실행해야 합니다.

Team Foundation Server 응용 프로그램 풀(응용 프로그램 풀)
ReportServer(응용 프로그램 서버)

참고:

ReportServer 응용 프로그램 풀은 SQL Server 2008이 아닌 SQL Server 2005의 IIS(인터넷 정보 서비스)에서 관리합니다.
SQL Server Reporting Services(프로그램)

참고:
ReportServer 응용 프로그램 풀은 SQL Server 2008이 아닌 SQL Server 2005의 IIS(인터넷 정보 서비스)에서 관리합니다.

필수 권한

RenameDT 명령을 사용하려면 Team Foundation 응용 프로그램 계층 서버에서 Team Foundation Administrators 그룹의 멤버여야 하고 Team Foundation 데이터 계층 서버에서 SQL Server의 sysadmin 그룹 멤버여야 합니다. 자세한 내용은 Team Foundation Server 권한을 참조하십시오.

참고:
관리자 자격 증명으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에 대해 이 기능을 실행하려면 관리자 명령 프롬프트를 열어야 합니다. 관리자 명령 프롬프트를 열려면 시작을 클릭하고 명령 프롬프트를 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 클릭합니다. 자세한 내용은 Microsoft 웹 사이트를 참조하십시오.

관리자 자격 증명으로 로그온한 경우에도 Windows Server 2008을 실행하는 서버에 대해 이 기능을 실행하려면 관리자 명령 프롬프트를 열어야 합니다. 관리자 명령 프롬프트를 열려면 시작을 클릭하고 명령 프롬프트를 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 클릭합니다. 자세한 내용은 Microsoft 웹 사이트를 참조하십시오.

TFSAdminUtil RenameDT servername

매개 변수

인수	설명
servername	대상 데이터 계층 컴퓨터의 이름을 지정합니다. 컴퓨터는 다음 형식으로 식별할 수 있습니다. IP 주소 IP 주소는 aaa.bbb.ccc.ddd 형식이어야 합니다. 컴퓨터 이름 공백이나 ";:<>*와 같은 특수 문자는 허용되지 않으며 A-Z까지의 문자, 0-9까지의 숫자와 -만 허용됩니다. 컴퓨터 이름에 숫자만 사용할 수 없으며, 일반 ASCII의 경우 최대 15자가, 이보다 큰 문자 인코딩의 경우 최대 7자가 허용됩니다. 자세한 내용은 Team Foundation Server의 명명 제한을 참조하십시오. 도메인 주소 예를 들면 Myserver.location.mycompanyt.com과 같습니다.

servername

대상 데이터 계층 컴퓨터의 이름을 지정합니다. 컴퓨터는 다음 형식으로 식별할 수 있습니다.

IP 주소

IP 주소는 aaa.bbb.ccc.ddd 형식이어야 합니다.
컴퓨터 이름

공백이나 ";:<>*와 같은 특수 문자는 허용되지 않으며 A-Z까지의 문자, 0-9까지의 숫자와 -만 허용됩니다. 컴퓨터 이름에 숫자만 사용할 수 없으며, 일반 ASCII의 경우 최대 15자가, 이보다 큰 문자 인코딩의 경우 최대 7자가 허용됩니다. 자세한 내용은 Team Foundation Server의 명명 제한을 참조하십시오.
도메인 주소

예를 들면 Myserver.location.mycompanyt.com과 같습니다.

설명

중요:
Team Foundation Server 데이터 계층 서버의 데이터베이스를 백업하는 것이 좋습니다.

서비스 Web.config 파일의 TFSNameUrl 및 TFS Name 문자열(데이터 계층의 Drive:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services에 있음)은 현재 Team Foundation Server 데이터 계층 서버를 참조해야 합니다. 그렇지 않으면 RenameDT 명령이 자동으로 실패합니다.

Team Foundation Server 응용 프로그램 계층에서 데이터 계층 서버에 연결하려면 데이터 계층 서버의 정확한 이름이나 주소를 알고 있어야 합니다. 데이터 계층의 이름과 주소는 Team Foundation Server 응용 프로그램 계층과 데이터 계층 데이터베이스의 여러 위치에 저장됩니다. 새 데이터 계층으로 전환해야 할 경우에는 관리자가 Team Foundation Server에서 새 데이터 계층 이름이나 주소를 가리키도록 변경해야 합니다.

TFSAdminUtil 명령줄 유틸리티의 RenameDT 명령은 새 이름이나 주소를 가리키도록 Team Foundation Server를 업데이트하여 데이터 계층의 이름을 바꾸는 프로세스를 자동화합니다. RenameDT 명령을 스크립트로 만들어 데이터 계층 이름 바꾸기 프로세스를 자동화하거나 예약할 수도 있습니다.

RenameDT 명령은 명령이 실행되는 컴퓨터에서 web.config 파일을 검색하므로 응용 프로그램 계층에서만 실행할 수 있습니다. 원격에서는 작동하지 않으며 대상 응용 프로그램 계층 컴퓨터를 지정하기 위해 다른 매개 변수를 사용하지 않습니다.

명령 사용 예

관리자는 다양한 경우에 RenameDT 명령을 사용할 수 있습니다. 예를 들어 다음과 같은 경우에 이 명령을 사용할 수 있습니다.

관리자가 데이터 계층에 대해 일상적인 유지 관리 작업을 수행해야 하고, 작동 중지 시간이 발생하지 않도록 데이터 계층을 다른 임시 데이터 계층으로 대체한 후 오프라인 상태로 만들어야 합니다.
관리자가 TFSAdminUtil 명령줄 유틸리티의 RenameDT 명령을 실행하여 Team Foundation Server에서 새 임시 데이터 계층에 연결하도록 만듭니다. 유지 관리 작업이 완료되면 유틸리티를 다시 실행하여 이전 데이터 계층으로 다시 변경합니다.
데이터 계층에 오류가 발생하여 작동하지 않습니다.
관리자가 RenameDT 명령을 실행하여 Team Foundation Server가 새 백업 서버를 가리키도록 만듭니다.
데이터 계층을 새 서버로 업그레이드합니다.
관리자가 RenameDT 명령을 실행하여 Team Foundation Server가 새 데이터 계층 서버를 가리키도록 만듭니다.
새로운 작업 정책에 데이터 계층이 준수해야 할 컴퓨터 명명 표준이 명시되어 있습니다.
관리자가 RenameDT 명령을 사용하여 데이터 계층의 이름을 더 적절한 이름으로 바꿉니다.
조직이나 기업의 규모가 커져 단일 서버 솔루션에서 이중 서버 솔루션으로 마이그레이션해야 합니다.
새로운 독립 데이터 계층을 설정한 후, 관리자가 RenameDT 명령을 실행하여 Team Foundation Server가 새 서버를 가리키도록 만듭니다.