チームプロジェクトコレクションからの作業項目フィールドの削除

[アーティクル]
08/09/2011

witadmin コマンドラインツールを使用すると、既存のチームプロジェクトコレクションから作業項目の種類フィールドを削除できます。削除するフィールドを現在使用している場合は、作業項目の種類からそのフィールドを先に削除する必要があります。

このトピックの内容

使用されていないフィールドの一覧表示
使用中でないフィールドの検証
チームプロジェクトコレクションからのフィールドの削除

必要なアクセス許可

この手順を実行するには、Team Foundation 管理者グループのメンバーである必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。

使用されていないフィールドの一覧表示

どの作業項目の種類でも使用されていないフィールドを一覧表示するには

コマンドプロンプトウィンドウを開きます。
次のコマンドを入力し、Enter キーを押して、一覧表示する作業項目の種類を格納するディレクトリに変更します。

cd ..ドライブ:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE

コマンドプロンプトで次のコマンドを入力して Enter キーを押し、どの作業項目の種類からも現在使用されていないフィールドを一覧表示します。

witadmin listfields /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /unused

次に示すように、使用されていない各フィールドのフィールドおよび属性情報が表示されます。

Field: Microsoft.VSTS.CMMI.TaskType
Name: Task Type
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Flag
Name: Flag
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Progress
Name: Progress
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

使用中でないフィールドの検証

フィールドがどの作業項目の種類でも使用されていないことを検証するには

コマンドプロンプトウィンドウを開きます。
次のコマンドを入力し、Enter キーを押して、作業項目の種類を格納するディレクトリに変更します。

cd ..ドライブ:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE
コマンドプロンプトで次のように入力し、Enter キーを押して、フィールドがどの作業項目の種類でも使用されなくなっていることを検証します。
```
witadmin listfields /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /n:FieldName
```
フィールドごとに表示される情報で、次の例で示すように Use の値が "Not In Use" になっていることを検証します。
```
Field: MyCompany.MyProcess.MyField
Name: MyField
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False
```
Use フィールドで、そのフィールドが使用中であると示された場合は、一覧表示されている各チームプロジェクトの各作業項目の種類から、そのフィールドを削除する必要があります。たとえば、Microsoft.VSTS.TCM.SystemInfo フィールドは、Arroyo、Desert、Palm および Springs という 4 つのプロジェクトで、Bug および Code Defect という作業項目の種類によって使用されています。
```
Field: Microsoft.VSTS.TCM.SystemInfo
Name: System Info
Type: Html
Reportable As: None
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)
Indexed: False
```
このフィールドを削除する前に、このフィールドが定義されている各チームプロジェクトについて一覧表示されている作業項目の種類から、フィールドを削除する必要があります。詳細については、「作業項目の種類に対するフィールドの追加と削除」を参照してください。

チームプロジェクトコレクションからのフィールドの削除

チームプロジェクトコレクションからフィールドを削除するには

コマンドプロンプトで次のコマンドを入力し、Enter キーを押します。
```
witadmin deletefield /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /n:FieldName
```
確認プロンプトで「y」と入力して、この手順を完了します。

参照

処理手順

作業項目の種類に対するフィールドの追加と削除

参照

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

作業項目フィールドの管理 [witadmin]

チーム プロジェクト コレクションからの作業項目フィールドの削除