次の方法で共有


作業項目の種類のカスタマイズおよび管理

次の witadmin コマンドを使用して、チーム プロジェクトの作業項目の種類を管理できます。

  • destroywitd: ある特定の作業項目の種類を破棄し、その種類のすべての作業項目を復元できないように完全に破棄します。

  • exportwitd: 作業項目の種類の定義を、XML ファイルまたはコマンド プロンプト ウィンドウにエクスポートします。

  • importwitd: 作業項目の種類を、XML 定義ファイルから Team Foundation Server を実行するサーバーのチーム プロジェクトにインポートします。同じ名前の作業項目の種類が既に存在する場合は、新しい作業項目の種類の定義によって既存の定義が上書きされます。同じ名前の作業項目の種類が存在しない場合は、新しい作業項目の種類が作成されます。ファイルをインポートしないで、作業項目の種類を定義する XML を検証するには、/v オプションを使用します。

  • listwitd: 指定したプロジェクト内の作業項目の種類の名前を、コマンド プロンプト ウィンドウに表示します。

  • renamewitd: 特定のプロジェクト内にある作業項目の種類の表示名を変更します。このコマンドを実行した後、この種類の作業項目には新しい名前が表示されます。

witadmin コマンド ライン ツールを実行するには、Visual Studio か チーム エクスプローラー のいずれかがインストールされているコマンド プロンプト ウィンドウを開き、次のように入力します。

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

64 ビット版の Windows で、%programfiles% を %programfiles(x86)% に置き換えます。

作業項目の種類の詳細については、「プロセス テンプレートへの作業項目の種類定義の追加」を参照してください。

[!メモ]

作業項目の種類は、Visual Studio のパワー ツールであるプロセス エディターを使用して作成および変更できます。このツールはサポートされていません。詳細については、Microsoft Web サイトの「Team Foundation Server Power Tools (Team Foundation Server パワー ツール)」を参照してください。

要件

作業項目の種類が定義されているチーム プロジェクトに対して、次のアクセス許可を設定する必要があります。

  • 作業項目の種類をエクスポートまたは一覧表示するには、プロジェクト管理者グループのメンバーであるか、[プロジェクトレベル情報を表示します] のアクセス許可が [許可] に設定されている必要があります。

  • 作業項目の種類の破棄、インポート、または名前変更を行うには、Team Foundation 管理者セキュリティ グループまたはプロジェクト管理者セキュリティ グループのメンバーである必要があります。

詳細については、「Team Foundation Server のアクセス許可」および「Team Foundation Server の既定のグループ、アクセス許可、およびロール」を参照してください。

[!メモ]

管理者のアクセス許可を使ってログオンしている場合でも、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。昇格した特権でコマンド プロンプト ウィンドウを開くには、[スタート] を選択し、[コマンド プロンプト] のショートカット メニューを開き、[管理者として実行] を選択します。詳細については、Microsoft Web サイトの「ユーザー アカウント制御」を参照してください。

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

パラメーター

パラメーター

説明

/collection:CollectionURL

チーム プロジェクト コレクションの URI を指定します。URI の形式は http://ServerName:Port/VirtualDirectoryName/CollectionName です。

仮想ディレクトリを使用していない場合、URI の形式は次のようになります。

http://ServerName:Port/CollectionName

/p:Project

作業項目の種類を管理するチーム プロジェクト。このチーム プロジェクトは、/collection パラメーターで指定されているプロジェクト コレクションで定義されている必要があります。

/v オプションを指定して importwitd コマンドを実行する場合を除き、/p パラメーターは必須です。

/n:TypeName

破棄、エクスポート、インポート、または名前を変更する作業項目の種類の名前。

/f:FileName

エクスポートまたはインポートする作業項目の種類を含む XML 定義ファイルのパスとファイル名。exportwitd コマンドの使用時にこのパラメーターを省略すると、XML はコマンド プロンプト ウィンドウに表示されます。

メモメモ
Windows Vista を使用している場合、アクセス許可を持たないフォルダーが存在する可能性があります。アクセス許可がない場所に作業項目の種類をエクスポートしようとすると、レジストリ仮想化テクノロジが、自動的にエクスポートされたファイルをリダイレクトし、仮想ストアに保存します。このリダイレクトが行われないようにするには、アクセス許可のある場所にファイルをエクスポートします。レジストリの仮想化の詳細については、Microsoft Web サイトの「Registry Virtualization (レジストリの仮想化)」および「Windows Vista または Windows 7 のファイルおよびレジストリの仮想化に関する一般的な問題」を参照してください。

/e:Encoding

.NET Framework 2.0 のエンコーディング形式の名前。XML データをエクスポートまたはインポートするときに、指定したエンコーディングを使用します。たとえば、/e:utf-7 は Unicode (UTF-7) エンコーディングを指定します。このパラメーターを省略すると、witadmin はエンコーディングの検出を試みます。検出に失敗した場合、witadmin は UTF-8 を使用します。

/exportgloballists

作業項目の種類で参照されるグローバル リストの定義をエクスポートします。グローバル リストの定義は、作業項目の種類の定義 XML に埋め込まれます。指定しない場合、グローバル リストの定義は省略されます。

/v

作業項目の種類を定義する XML の検証だけを行い、XML 定義ファイルはインポートしません。

メモメモ
チーム プロジェクトを指定せずに種類の定義を検証できます。プロジェクト スコープのグループの参照は無視されます。

/new:NewName

作業項目の種類の新しい名前。

/noprompt

確認のプロンプトを無効にします。

/? または help

コマンド プロンプト ウィンドウにコマンドのヘルプを表示します。

解説

destroywitd コマンドを使用すると、次のすべてのオブジェクトが破棄されます。

  • 作業項目の種類

  • その種類のすべての作業項目

  • 作業項目テーブル、長いテキスト テーブル、およびリンク テーブルの対応するエントリ

  • 作業項目の種類のメタデータ キャッシュ内のオブジェクト

特に指定されていない場合、それぞれの例に適用される値は次のとおりです。

  • チーム プロジェクト コレクションの URI: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • プロジェクト名: AdventureWorks

  • 入力または出力ファイル名: myworkitems.xml

  • 作業項目の種類の名前: myworkitem

  • 既定のエンコーディング: UTF-8

Dd312129.collapse_all(ja-jp,VS.110).gif作業項目の種類の定義のエクスポート

次のコマンドは、myworkitem の定義を myworkitems.xml ファイルにエクスポートします。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

次の例は、Unicode (UTF-7) エンコーディングを使用して作業項目をエクスポートします。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Dd312129.collapse_all(ja-jp,VS.110).gif作業項目の種類の定義および参照先のグローバル リストのエクスポート

次の例は、作業項目の種類とその参照先のグローバル リストをエクスポートします。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Dd312129.collapse_all(ja-jp,VS.110).gif作業項目の種類の定義の一覧表示

次の例は、作業項目の種類の定義をコマンド プロンプト ウィンドウに表示します。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Dd312129.collapse_all(ja-jp,VS.110).gif作業項目の種類の定義のインポート

次の例は、作業項目の定義を XML ファイルからインポートします。

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Dd312129.collapse_all(ja-jp,VS.110).gif作業項目の種類の XML 定義の検証

次の例は、作業項目の種類を定義する XML を検証しますが、定義のインポートは行いません。

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

参照

処理手順

作業項目の種類を作成する

概念

プロジェクトの追跡データ、フォーム、ワークフロー、その他のオブジェクトのカスタマイズ

その他の技術情報

witAdmin: 作業項目を追跡するためのオブジェクトのカスタマイズおよび管理