作業項目の種類のカテゴリのカスタマイズ
次の witadmin コマンドを使用して、チーム プロジェクトに対して定義されている作業項目の種類のカテゴリを管理できます。
exportcategories: Team Foundation Server を実行しているサーバーで定義されているカテゴリの XML 定義をエクスポートします。
importcategories: 作業項目の種類の XML 定義ファイルを、Team Foundation Server を実行するサーバーのチーム プロジェクトにインポートします。
同じ名前のカテゴリが既に存在する場合、このコマンドは既存の定義を上書きします。 同じ名前の作業項目の種類が存在しない場合は、新しいカテゴリが作成されます。
witadmin コマンド ライン ユーティリティは、チーム エクスプローラーを実行するクライアント コンピューターの Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE にあります。
注意
カテゴリは、Visual Studio のパワー ツールであるプロセス エディターを使用して作成および変更できます。 このパワー ツールはサポートされていません。 詳細については、Microsoft Web サイトの「Team Foundation Server Power Tools April 2010 (Team Foundation Server パワー ツール (2010 年 4 月))」を参照してください。
必要なアクセス許可
作業項目の種類が定義されているチーム プロジェクトに対して、次のアクセス許可を設定する必要があります。
作業項目の種類のカテゴリをエクスポートするには、読み取りユーザー グループのメンバーであるか、[このノードの作業項目を表示します] のアクセス許可が [許可] に設定されている必要があります。
作業項目の種類のカテゴリをインポートするには、Team Foundation 管理者セキュリティ グループまたはプロジェクト管理者セキュリティ グループのメンバーである必要があります。
詳細については、「Team Foundation Server のアクセス許可」および「Team Foundation Server の既定のグループ、アクセス許可、およびロール」を参照してください。
注意
管理者のアクセス許可を使ってログオンした場合であっても、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。 昇格した特権でコマンド プロンプト ウィンドウを開くには、[スタート] ボタンをクリックし、[コマンド プロンプト] を右クリックして、[管理者として実行] をクリックします。 詳細については、Microsoft Web サイトの「ユーザー アカウント制御」を参照してください。
witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding]
witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]
パラメーター
パラメーター |
説明 |
|---|---|
/collection:CollectionURL |
チーム プロジェクト コレクションの URI を指定します。 URI の形式は http://ServerName:Port/VirtualDirectoryName/CollectionName です。 仮想ディレクトリを使用していない場合、URI の形式は次のようになります。 http://ServerName:Port/CollectionName |
/p:Project |
カテゴリのエクスポート元またはカテゴリのインポート先のチーム プロジェクトの名前。 |
/f:FileName |
エクスポートまたはインポートするカテゴリを含む XML 定義ファイルのパスとファイル名。 exportcategories コマンドの使用時にこのパラメーターを省略すると、カテゴリの一覧はコマンド プロンプト ウィンドウに表示されます。 |
/e:Encoding |
.NET Framework 2.0 のエンコーディング形式の名前。 XML データをエクスポートまたはインポートするときに、指定したエンコーディングを使用します。 たとえば、/e:utf-7 は Unicode (UTF-7) エンコーディングを指定します。 このパラメーターを省略すると、witadmin はエンコーディングの検出を試みます。検出に失敗した場合、witadmin は UTF-8 を使用します。 |
/? または help |
コマンド プロンプト ウィンドウにコマンドのヘルプを表示します。 |
解説
カテゴリ ファイルをインポートすると、カテゴリがまだ存在しない場合は作成されます。 カテゴリが既に存在する場合は、witadmin importcategories コマンドから、現在のリストが上書きされるという警告が出力されます。 独自のプログラムを作成して既存のカテゴリのセットを更新したり、新しいデータに基づいてカテゴリを自分で更新したりできます。
カテゴリの XML ファイルの構造については、「カテゴリ定義のスキーマ リファレンス」を参照してください。
例
特に指定されていない場合、それぞれの例に適用される値は次のとおりです。
チーム プロジェクト コレクションの URI: http://AdventureWorksServer:8080/AWTeam/Collection1
プロジェクト名: AdventureWorks
入力または出力ファイル名: myCategories.xml
既定のエンコーディング: UTF-8
作業項目の種類のカテゴリの一覧表示
次のコマンドは、AdventureWorks プロジェクトに定義されている作業項目の種類のカテゴリを一覧表示します。
witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks
作業項目の種類のカテゴリのエクスポート
次のコマンドは、AdventureWorks プロジェクトに対して定義されている作業項目の種類のカテゴリを myCategories XML ファイルにエクスポートします。
witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml
作業項目の種類のカテゴリのインポート
次の例は、myCategories XML ファイルから AdventureWorks プロジェクトにカテゴリをインポートします。
witadmin importcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml