作業項目の完全な削除 [witadmin]
Team Foundation コマンドを使用することで、チーム プロジェクト コレクションの witadmin destroywi データベースから作業項目を完全に削除できます。 状態が "終了" に設定されている作業項目はデータベース内に残っているので、再アクティブ化できます。 完全に削除した作業項目はデータベースから削除されるので、復元または再アクティブ化することはできません。
各作業項目は、Team Foundation データベースに格納されて、一意の識別子を割り当てられているオブジェクトを表します。この識別子は作業項目 ID と呼ばれます。 作業項目 ID は、プロジェクト コレクション内で一意です。
witadmin コマンド ライン ツールは、オンプレミスの TFS に対して実行される場合にのみ機能します。 このツールを実行するには、Visual Studio またはチーム エクスプローラーがインストールされている環境でコマンド プロンプト ウィンドウを開き、次のように入力します。
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
32 ビット版の Windows で、%programfiles(x86)% を %programfiles% に置き換えます。
必要条件
- [Team Foundation 管理者] セキュリティ グループのメンバーまたはチーム プロジェクト コレクションの [プロジェクト管理者] セキュリティ グループのメンバーである必要があります。 「Team Foundation Server のアクセス許可の参照」を参照してください。
注意
管理者のアクセス許可を使ってログオンしている場合でも、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。昇格した特権でコマンド プロンプト ウィンドウを開くには、[スタート] ボタンをクリックし、[コマンド プロンプト] のショートカット メニューを開いて、[管理者として実行] をクリックします。詳細については、Microsoft Web サイトを参照してください。
witadmin destroywi /collection:CollectionURL /id:id [/noprompt]
パラメーター
パラメーター |
説明 |
|---|---|
/collection:CollectionURL |
チーム プロジェクト コレクションの URI を指定します。 URI の形式は http://ServerName:Port/VirtualDirectoryName/CollectionName です。 仮想ディレクトリを使用していない場合、URI の形式は次のようになります。 http://ServerName:Port/CollectionName |
/id:id |
破棄する作業項目の ID です。 複数の作業項目を指定するには、コンマだけで ID を区切ります。間に空白文字を入れないでください。 |
/noprompt |
確認のプロンプトを無効にします。 |
/? または help |
コマンド プロンプト ウィンドウにコマンドのヘルプを表示します。 |
例
データベースからの作業項目の完全な削除
次の例では、AdventureWorksServer サーバー上にある Collection1 用のデータベースから作業項目 2003 を削除します。
witadmin destroywi /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /id:2003
次の例では、AdventureWorksServer サーバー上にある Collection1 用のデータベースから、ID が 12、15、23 の作業項目を削除します。
witadmin destroywi /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /id:12,15,23