リンクの種類の管理

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

重要

オンプレミスの XML プロセスモデルでは、 witadmin を使用して、プロジェクトのプロセスの一覧表示、インポート、エクスポート、および変更を行うことができます。 継承およびホストされた XML プロセスモデルでは、 witadmin を使用してプロセス情報を一覧表示し、エクスポートすることしかできません。 プロセスモデルの概要とサポートされている機能については、「 作業追跡エクスペリエンスのカスタマイズ」を参照してください。

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

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

  • deactivatelinktype: 指定されたリンクの種類を非アクティブにします。 ユーザーはこの種類のリンクを作成できなくなります。 この種類の既存のリンクは、これまでどおり正常に機能します。
  • deletelinktype: 指定されたリンクの種類をデータベースから完全に削除します。 このリンクの種類で定義されているすべてのリンクも削除されます。
  • exportlinktype: リンクの種類の定義をエクスポートします。 サーバーに対して定義されている 1 つのリンクの種類またはすべてのリンクの種類の定義をエクスポートできます。
  • importlinktype: XML ファイルからリンクの種類の定義をインポートします。 同じ参照名のリンクの種類が既に存在する場合は、インポートしたリンクの種類に一致するように更新されます。 リンクの種類がまだ存在していない場合は、新しいリンクの種類が作成されます。
  • listlinktypes: サーバーで使用できる一連のリンクの種類を一覧表示します。
  • reactivatelinktype: 指定されたリンクの種類を再アクティブ化し、必要に応じて新しい名前を割り当てます。

Witadmin コマンドラインツールを実行する方法

witadminコマンドラインツールを実行するには Visual Studio がインストールされているコマンドプロンプトウィンドウを開きます。 Witadminコマンドラインツールは、任意のバージョンの Visual Studio と共にインストールされます。 このツールにアクセスするには、無料版のVisual Studio Community または Visual Studio チームエクスプローラーをインストールします。

注意

オンプレミスのサーバーに接続している場合は、Azure DevOps Server と同じまたはそれ以降のバージョンの Visual Studio またはチームエクスプローラーを使用する必要があります。 たとえば、TFS 2017 インスタンスに接続する場合は、Visual Studio 2017 またはチームエクスプローラー2017から接続する必要があります。 チームエクスプローラー2015バージョンはありません。

Visual Studio 2019 またはチームエクスプローラー2019クライアント:

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

TeamExplorerProfessional インストールされているバージョンに応じて、の Community 代わりに、、、または Enterprise

Visual Studio 2017 またはチームエクスプローラー2017クライアント:

%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

TeamExplorerProfessional インストールされているバージョンに応じて、の Community 代わりに、、、または Enterprise

Windows の 32-bit エディションで、 % programfiles (x86)%% programfiles%に置き換えます。 Visual Studio Community (チームエクスプローラーへのアクセスを提供する) または Visual Studio チームエクスプローラー2017を無料でインストールできます。

必須コンポーネント

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

  • リンクの種類を一覧表示またはエクスポートするには、コレクション内のプロジェクトに対する [ プロジェクトレベル情報の表示 ] アクセス許可が [ 許可] に設定されている必要があります。
  • リンクの種類を削除、インポート、または事後対応するには、 Project コレクション管理者セキュリティグループのメンバーであるか、または [作業項目リンクの種類の管理] アクセス許可が [許可] に設定されている必要があります。

詳細については、「 プロジェクトコレクションレベルのアクセス許可を変更する」を参照してください。

注意

管理アクセス許可を使用してサインインした場合でも、Windows server 2008 を実行しているサーバーでこの機能を実行するには、管理者特権でのコマンドプロンプトウィンドウを開く必要があります。 管理者特権でのコマンドプロンプトウィンドウを開くには、[ スタート] ボタンをクリックし、[ コマンドプロンプト ] ショートカットメニューを開き、[ 管理者として実行] を選択します。 詳細については、Microsoft Web サイトの「ユーザー Access Control」を参照してください。

構文

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 を指定します。 次に例を示します。

http://ServerName: Port/VirtualDirectoryName/CollectionName

仮想ディレクトリが使用されていない場合、URI の形式は次のようになります。 http://ServerName: Port/CollectionName
ms-dosLinkName 非アクティブ化または削除するリンクの種類の名前または参照名。
/fFileName リンクの種類の XML ファイル。 インポートの場合は必須、エクスポートの場合は省略可能です。 このパラメーターを省略すると、コマンド出力はディスプレイに表示されます。
/eencoding .NET Framework 2.0 エンコード形式の名前。 XML データをエクスポートまたはインポートするときに、指定したエンコーディングを使用します。 たとえば、は /e:utf-7 Unicode (utf-7) エンコーディングを指定します。 このパラメーターを省略すると、 witadmin はエンコーディングの検出を試み、検出が失敗した場合、 witadmin は utf-8 を使用します。
/v インポートしないでリンクの種類の XML を検証します。
/noprompt 確認のプロンプトを無効にします。
/? または ヘルプ コマンド プロンプト ウィンドウにコマンドのヘルプを表示します。

Remarks

リンクの種類の定義スキーマの構造、またはチームメンバーが行うことができるリンク関係の種類を制限する方法については、「 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