リンクの種類の管理 [witadmin]

  • [アーティクル]

作業項目の種類と同様に、カスタムのリンクの種類を定義および変更できます。 ただし、システム定義のリンクの種類を変更することはできません。 チーム プロジェクト コレクションに新しいリンクの種類を追加する前に、使用できるリンクの種類を確認します。 「依存関係の管理、追跡可能性をサポートする作業項目のリンク」を参照してください。

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

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

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

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

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

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

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

witadmin コマンド ライン ツールは、オンプレミスの TFS に対して実行される場合にのみ機能します。 このツールを実行するには、Visual Studio またはチーム エクスプローラーがインストールされている環境でコマンド プロンプト ウィンドウを開き、次のように入力します。

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

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

必要条件

リンクの種類が定義されているチーム プロジェクト コレクションに対して、次のアクセス許可を設定する必要があります。

  • リンクの種類を一覧表示またはエクスポートするには、コレクション内のチーム プロジェクトの [プロジェクトレベル情報を表示します] のアクセス許可が [許可] に設定されている必要があります。

  • リンクの種類を削除、インポート、または再アクティブ化するには、プロジェクト コレクション管理者セキュリティ グループのメンバーであるか、または [作業項目リンクの種類の管理] のアクセス許可が [許可] に設定されている必要があります。

詳細については、「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

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

解説

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

チーム メンバーが作成できるリンク関係の種類を制限する方法については、「リンク コントロール、制約、フィールドのリファレンス」と「LinksControlOptions 要素」を参照してください。

使用例

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

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

  • サーバー名: AdventureWorksServer

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

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

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

リンクの種類の一覧表示

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

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

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

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

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

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

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

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

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

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

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

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

参照

概念

リンクの種類要素のリファレンス

リンク コントロール、制約、フィールドのリファレンス

その他の技術情報

依存関係の管理、追跡可能性をサポートする作業項目のリンク

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