リンクの種類のカスタマイズと管理

  • [アーティクル]

次の witadmin コマンドを使用して、チーム プロジェクト コレクションに対して定義されているリンクの種類を管理できます。

  • deactivatelinktype: 指定したリンクの種類を非アクティブにします。 ユーザーはこの種類のリンクを作成できなくなります。 この種類の既存のリンクは、これまでどおり正常に機能します。

  • deletelinktype: 指定したリンクの種類をデータベースから完全に削除します。 このリンクの種類で定義されているすべてのリンクも削除されます。

  • exportlinktype: リンクの種類の定義をエクスポートします。 サーバーに対して定義されている 1 つのリンクの種類またはすべてのリンクの種類の定義をエクスポートできます。

  • importlinktype: リンクの種類の定義を XML ファイルからインポートします。 同じ参照名のリンクの種類が既に存在する場合は、インポートしたリンクの種類に一致するように更新されます。 リンクの種類がまだ存在していない場合は、新しいリンクの種類が作成されます。

  • listlinktypes: サーバーで使用できるリンクの種類を一覧表示します。

  • reactivatelinktype: 指定したリンクの種類を再度アクティブにし、必要に応じて新しい名前を割り当てます。

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 deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

パラメーター

パラメーター

説明

/collection:CollectionURL

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

次に例を示します。

http://ServerName:8080/tfs/Collection0

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

http://ServerName:Port/CollectionName

/n:LinkName

非アクティブ化または削除するリンクの種類の名前または参照名。

/f:FileName

リンクの種類の XML ファイル。 インポートの場合は必須、エクスポートの場合は省略可能です。 このパラメーターを省略すると、コマンド出力はディスプレイに表示されます。

/e:encoding

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

/v

インポートしないでリンクの種類の XML を検証します。

/noprompt

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

/? または help

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

解説

リンクの種類の定義スキーマの構造については、「リンクの種類の操作」を参照してください。

例

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

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

  • サーバー名: AdventureWorksServer

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

  • リンクの種類の名前: mylinktype

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

リンクの種類の一覧表示

次のコマンドは、Team Foundation AdventureWorksServer に対して定義されているカスタムのリンクの種類を表示します。

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

リンクの種類の定義の一覧表示

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

リンクの種類の非アクティブ化と再アクティブ化

次の例は、リンクの種類 mylinktype を非アクティブにしてから再度アクティブにします。

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype

リンクの種類の定義のエクスポート

次のコマンドは、すべてのリンクの種類の定義をファイル mylinktype.xml にエクスポートします。

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

リンクの種類の定義のインポート

次の例は、XML ファイルで定義されているリンクの種類の定義をインポートします。

witadmin importlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

参照

処理手順

リンクの種類の追加

概念

リンクの種類の操作

その他の技術情報

作業項目のリンク (アジャイル)

作業項目のリンク (CMMI)

作業項目間および他のリソースとの間の関係の作成

witAdmin: 作業項目を追跡するオブジェクトの管理