作業項目の種類のカスタマイズと管理

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

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

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

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

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

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

witadmin コマンド ライン ユーティリティは、チーム エクスプローラーを実行するクライアント コンピューターの Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE にあります。 

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

必要なアクセス許可

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

• 作業項目の種類をエクスポートまたは一覧表示するには、読み取りユーザー グループのメンバーであるか、[このノードの作業項目を表示します] のアクセス許可が [許可] に設定されている必要があります。

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

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

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/AWTeam/Collection1

• プロジェクト名: AdventureWorks

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

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

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

作業項目の種類の定義のエクスポート

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

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

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

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

作業項目の種類の定義および参照先のグローバル リストのエクスポート

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

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

作業項目の種類の定義の一覧表示

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

witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /n:myworkitem

作業項目の種類の定義のインポート

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

witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks

作業項目の種類の XML 定義の検証

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

witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks /v

参照

処理手順

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