Stop コマンド (Team Foundation ビルド)
stop コマンドを使用すると、Team Foundation ビルド の現在実行中のビルド定義を停止できます。
必要なアクセス許可
stop コマンドを使用するには、Visual Studio Team Foundation Server の [ビルドの停止] のセキュリティ アクセス許可が [許可] に設定されている必要があります。 詳細については、「Team Foundation Server のアクセス許可」を参照してください。
TFSBuild stop /collection:teamProjectCollectionUrl /buildDefinition:definitionSpec buildNumbers [/noprompt] [/silent]
TFSBuild stop /collection:teamProjectCollectionUrl buildUris [/noprompt] [/silent]
TFSBuild stop teamProjectCollectionUrl teamProject buildNumbers [/noprompt] [/silent]
パラメーター
引数 |
説明 |
|---|---|
teamProjectCollectionUrl |
停止するビルドを含むチーム プロジェクト コレクションの URL (http://myserver:8080/tfs/DefaultCollection など)。 |
teamProject |
このビルドが含まれるチーム プロジェクト名。 |
buildNumbers |
停止する必要があるビルド。 ビルド番号に空白が含まれる場合は、空白を引用符で囲んでください。 たとえば、「"myBuild 123"」のように指定します。 |
buildUris |
停止するビルド定義を指定するビルド URI の一覧。 |
definitionSpec |
停止するビルド定義の仕様。 |
オプション |
説明 |
|---|---|
/collection |
チーム プロジェクト コレクションを指定します。 |
/noprompt |
ビルドを停止するときにプロンプトを表示しません。 |
/silent |
ビルドを停止する間、コンソールに出力を書き込みません。 |
/builddefinition |
停止するビルド定義を指定します。 |
使用例
次の例は、実行中のビルド番号 Nightly.025 を停止します。Nightly.025 は、http://myserver:8080/DefaultCollection にあるコレクションの AdventureWorks チーム プロジェクトにあります。
>TFSBuild stop http://myserver:8080/DefaultCollection AdventureWorks Nightly.025
次の例は、Nightly.20130.0 definitionspec に関連付けられている Nightly という名前のビルドの実行を停止します。
>TFSBuild stop /collection:http://myserver:8080/DefaultCollection /builddefinition:\teamproject\Nightly Nightly.20130.0
次の例は、server01 上の "vstfs:///Nightly/Nightly/1" のビルド URI と "vstfs:///Nightly/Nightly/2" のビルド URI によって定義された実行中の 2 つのビルドを停止します。
> TFSBuild stop /collection:http://myserver:8080/DefaultCollection vstfs:///Nightly/Nightly/1 vstfs:///Nightly/Nightly/2