다음을 통해 공유

tcm: 명령줄 유틸리티를 사용하여 테스트 계획에서 테스트 실행

  • 아티클

명령줄에서 테스트 계획의 일부인 자동화된 테스트를 실행할 수 있습니다. 이를 통해 일괄 처리 파일로 테스트 실행을 시작하여 실행을 예약할 수 있습니다. 명령줄에서 테스트 실행을 관리할 수도 있습니다. 개발자가 Visual Studio를 사용하여 테스트 결과를 볼 수 있도록 테스트 실행을 내보내려는 경우 tcm을 사용하여 내보낼 수 있습니다. tcm을 사용하여 Visual Studio 테스트 실행 파일(.trx)에서 테스트 실행 결과를 게시할 수도 있습니다. 이 테스트 실행 파일에서 테스트 계획에 다시 게시하려는 결과를 지정할 수 있습니다. 다음 tcm 명령을 사용하여 이러한 작업을 완료할 수 있습니다.

  • tcm run /create

  • tcm run /list

  • tcm run /execute

  • tcm run /abort

  • tcm run /delete

  • tcm run /export

  • tcm run /publish

tcm.exe는 Visual Studio Ultimate, Visual Studio Premium 또는 Visual Studio Test Professional이 설치된 컴퓨터의 <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE에 있습니다.

자동화된 테스트를 테스트 프로젝트로 가져오고 이러한 테스트를 실행할 테스트 계획을 설정하는 방법에 대한 자세한 내용은 자동화된 테스트 어셈블리에서 테스트 사례 만들기와 tcm을 사용하여 명령줄에서 자동화된 테스트 실행을 참조하십시오.

tcm run /create /title:title /planid: id /collection:CollectionURL /teamproject:project (suiteid:id /configid:configid | /querytext: query) [/settingsname:name] [/owner:owner] [/builddir:directory]  [/testenvironment:name] [/login:username,[password]] [/include]

tcm run /execute /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /list [/planid:id | /querytext: query] /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /abort /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /delete /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]] [/noprompt]

tcm run /export /id:id /resultsfile:path /collection:CollectionURL /teamproject:project [/login:username,[password]] [/attachment:attachmentname]

tcm run /publish /suiteid:id /configid:id /resultowner:owner /resultsfile:path /collection:CollectionURL /teamproject:project    [/title: runtitle] [/runowner:owner] [/build:buildnumber /builddefinition:builddefinition] [/flavor:flavor [/platform:platform]  [/assignfailurestouser:user] [/login:username,[password]] [/buildverification]

매개 변수

매개 변수

설명

/collection:CollectionURL

팀 프로젝트 컬렉션의 URI를 지정합니다. URI의 형식은 http://ServerName:Port/VirtualDirectoryName/CollectionName입니다.

가상 디렉터리를 사용하지 않는 경우 URI 형식은 다음과 같습니다.

http://ServerName:Port/CollectionName

/teamproject:project

자동화된 테스트를 가져올 테스트 계획이 들어 있는 팀 프로젝트의 이름입니다.

/title: title

만들거나 테스트 실행 파일을 게시하는 실행에 대해 사용할 제목을 지정합니다.

/planid:id

실행하려는 테스트가 포함된 계획 또는 나열하려는 테스트 실행과 연결된 계획을 지정합니다.

/suiteid:id

실행할 테스트 도구 모음을 선택합니다.

또한 테스트 실행을 게시할 때 사용할 테스트 도구 모음을 지정할 수 있습니다.

참고

테스트 계획의 테스트 도구 모음을 나열하면 도구 모음 ID를 찾을 수 있습니다.자세한 내용은 tcm: 테스트 계획, 테스트 도구 모음, 테스트 구성 및 환경 나열을 참조하십시오.

팁

두 개 이상의 테스트 도구 모음을 실행하려면 /querytext 매개 변수를 사용합니다.

/configid:configid

테스트 도구 모음에 실행할 테스트 구성을 지정합니다.

또한 테스트 실행을 게시할 때 사용할 테스트 구성을 지정할 수 있습니다.

팁

두 개 이상의 테스트 구성을 실행하려면 /querytext 매개 변수를 사용합니다.

/querytext:query

테스트 실행을 반환하는 데 사용할 쿼리 또는 실행하려는 테스트를 선택하는 데 사용할 쿼리를 지정합니다.

팁

/querytext 매개 변수를 사용하여 두 개 이상의 테스트 도구 모음을 실행할 수 있습니다.예를 들면 다음과 같습니다.

querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)”

/settingsname:name

선택 사항입니다. 이 테스트 실행에 사용할 테스트 설정을 지정합니다. 이 매개 변수로 테스트 설정을 선택하지 않을 경우 테스트 계획의 자동화된 테스트에 기본 테스트 설정이 사용됩니다.

/owner:owner

선택 사항입니다. 테스트 실행의 소유자를 지정합니다.

/runowner:owner

선택 사항입니다. 테스트 실행의 소유자를 지정합니다.

/builddir:directory

선택 사항입니다. 자동화된 테스트의 테스트 어셈블리를 찾는 데 사용할 빌드 디렉터리를 지정합니다. 이 속성을 설정하지 않으면 현재 테스트 계획에 할당된 빌드를 기준으로 빌드 위치가 사용됩니다.

/testenvironment:name

선택 사항입니다. 이 테스트 실행에 사용할 테스트 환경을 지정합니다. 이 매개 변수로 테스트 환경을 선택하지 않을 경우 테스트 계획에서 자동화된 테스트에 대해 기본 테스트 환경이 사용됩니다.

/id:id

삭제하거나 중단하거나 내보낼 실행 ID를 지정합니다.

/resultsfile:path

테스트 실행을 내보낼 위치 또는 게시할 테스트 실행을 찾을 위치를 지정합니다. 예를 들면 "c:\temp\ResultsForDeveloper.trx"와 같습니다.

/attachment:attachmentname

내보내는 테스트 실행에 대한 첨부 파일의 이름을 지정합니다.

/resultowner:owner

테스트 결과의 소유자를 지정합니다.

/build:buildnumber

선택 사항입니다. 테스트 실행을 게시하는 데 사용할 빌드 번호를 지정합니다. 이 매개 변수는 /builddefinition과 함께 사용해야 합니다.

/builddefinition:builddefinition

선택 사항입니다. 테스트 실행을 게시하는 데 사용할 빌드 정의를 지정합니다. 이 매개 변수는 /build과 함께 사용해야 합니다.

/flavor:flavor

선택 사항입니다. 빌드 버전을 지정합니다. 예를 들면 릴리스로 지정할 수 있습니다. 이 매개 변수는 /build 매개 변수가 사용된 경우에만 사용됩니다.

/platform:platform

선택 사항입니다. 빌드 플랫폼을 지정합니다. 예를 들어, x86으로 지정할 수 있습니다. 이 매개 변수는 /build 매개 변수가 사용된 경우에만 사용됩니다.

/assignfailurestouser:user

선택 사항입니다. 테스트 실행에서 실패한 테스트를 할당할 사용자를 지정합니다.

/buildverification

선택 사항입니다. 이 테스트 실행에 빌드의 기본 기능을 검사하는 빌드 확인 테스트를 포함하도록 지정합니다.

/include

선택 사항입니다. 현재 활성 상태로 설정되어 있지 않은 테스트인 경우에도 테스트 실행에 모든 테스트를 선택하도록 지정합니다.

/noprompt

선택 사항입니다. 사용자에게 테스트 실행을 확인하는 메시지를 표시하지 않도록 지정합니다.

/login:username,[password]

선택 사항입니다. Team Foundation Server에 대한 응용 프로그램 계층 서버에 로그온한 사용자 및 명령 실행 권한을 가지고 있는 사용자의 이름과 암호를 지정합니다. 사용자의 Windows 자격 증명에 적절한 권한이 없는 경우, 기본 인증을 사용하는 경우 또는 도메인에 연결되지 않은 경우 이 옵션을 사용할 수 있습니다.

Visual Studio Online에 로그인하려면 아래 나와 있는 /allowalternatecredentials를 사용해야 합니다.

/allowalternatecredentials

Visual Studio Online에 연결할 때는 /login 매개 변수 외에도 이 플래그를 지정해야 합니다. 이 플래그는 Visual Studio 2013 업데이트 4 이상을 설치한 경우에만 사용할 수 있습니다.

tcm.exe와 같은 디렉터리(<Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE)에 있는 tcm.exe.config XML 파일에 /collection 및 /teamproject에 대한 매개 변수를 추가할 수 있습니다. 이를 파일에 추가하면 tcm 명령을 실행할 때마다 명령줄에서 매번 입력하지 않아도 됩니다. appSettings 섹션에 다음과 같이 이러한 키와 해당 값을 추가할 수 있습니다.

    <appSettings>
         <add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
         <add key ="TeamProject" value="DinnerNow"/>
    </appSettings>

테스트 실행 및 테스트 실행 관리

다음 예제는 Visual Studio 명령 프롬프트를 시작했다고 가정합니다.

이렇게 하려면 시작을 선택하고 모든 프로그램, Microsoft Visual Studio 2012, Visual Studio Tools를 차례로 가리킨 다음 개발자 명령 프롬프트를 선택합니다.

명령 프롬프트가 <drive>:\Program Files\Microsoft Visual Studio 11.0\VC 폴더에서 열립니다.

테스트 프로젝트에서 빌드된 어셈블리를 포함하는 폴더로 디렉터리를 변경합니다.

중요

tcm.exe를 사용하여 명령줄에서 자동화된 테스트를 실행하려면 테스트 사례를 자동화된 테스트에 연결해야 합니다.명령줄에 빌드 정보를 지정하지 않는 경우 빌드를 사용하여 실행할 자동화된 테스트를 찾을 수 있도록 테스트 계획도 올바르게 설정해야 합니다.이 작업을 수행하는 방법에 대한 자세한 내용은 방법: tcm.exe를 사용하여 자동화된 테스트의 어셈블리에서 테스트 사례 만들기를 참조하십시오.

다음 명령에 필요한 ID를 얻으려면 tcm을 사용하여 테스트 아티팩트 및 ID를 나열해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 tcm: 테스트 계획, 테스트 도구 모음, 테스트 구성 및 환경 나열 및 tcm을 사용하여 명령줄에서 자동화된 테스트 실행을 참조하십시오.

다음 명령은 테스트 지점 쿼리만 사용하여 테스트를 실행합니다.

tcm run /create /title:"Nightly Run" /planid:1 /querytext:"SELECT * FROM TestPoint WHERE ConfigurationId=13" /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

다음 명령은 특정 테스트 도구 모음과 구성을 사용하여 테스트를 실행합니다.

tcm run /create /title:"Nightly Run" /planid:1 /suiteid:5 /configid:13 /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

다음 명령은 특정 ID를 사용하여 테스트를 실행합니다.

Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>

다음 명령은 특정 테스트 계획에 대한 테스트 실행을 나열합니다.

tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>

다음 명령은 특정 테스트 실행을 삭제합니다.

tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>

다음 명령은 테스트 실행을 .trx 파일로 내보냅니다.

tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>

다음 명령은 특정 테스트 도구 모음과 구성에 대한 테스트 실행을 게시하고 소유자를 재할당합니다. 이는 이 구성과 쌍을 이루는 테스트 도구 모음에 있는 테스트 사례의 기존 테스트 지점을 .trx 파일의 결과에 업데이트합니다.

tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>

참고 항목

참조

tcm: 테스트 계획, 테스트 도구 모음, 테스트 구성 및 환경 나열

기타 리소스

tcm을 사용하여 테스트 계획에 대한 자동화된 테스트를 가져와 명령줄에서 실행