リンクの種類の管理 [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