作業項目の完全な削除
witadmin destroywi コマンドを使用することで、チーム プロジェクト コレクションの Team Foundation データベースから作業項目を完全に削除できます。 状態が "終了" に設定されている作業項目はデータベース内に残っているので、再アクティブ化できます。 完全に削除した作業項目はデータベースから削除されるので、復元または再アクティブ化することはできません。
各作業項目は、Team Foundation データベースに格納されて、一意の識別子を割り当てられているオブジェクトを表します。この識別子は作業項目 ID と呼ばれます。 作業項目 ID は、プロジェクト コレクション内で一意です。
witadmin コマンド ライン ユーティリティは、チーム エクスプローラーを実行するクライアント コンピューターの Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE にあります。
必要なアクセス許可
作業項目を完全に削除するには、Team Foundation Administrators セキュリティ グループのメンバーまたはチーム プロジェクト コレクションの Project Administrators セキュリティ グループのメンバーである必要があります。 詳細については、「Team Foundation Server のアクセス許可」および「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/AWTeam/Collection1 /id:2003
次の例では、AdventureWorksServer サーバー上にある Collection1 用のデータベースから、ID が 12、15、23 の作業項目を削除します。
witadmin destroywi /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /id:12,15,23