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

Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018-TFS 2013

重要

Witadmin では、xml 定義ファイルを変更して、オンプレミスの xml プロセスモデルをサポートできます。 プロセスモデルの概要とサポートされている機能については、「 作業追跡エクスペリエンスのカスタマイズ」を参照してください。

作業項目を追跡するオブジェクトを作成してカスタマイズすることで、チームの進行状況の追跡方法を変更できます。 Witadmin コマンドラインツールを使用すると、カテゴリ、グローバルリスト、グローバルワークフロー、リンクの種類、作業項目の種類などのオブジェクトを作成、削除、インポート、およびエクスポートできます。 作業項目の種類を完全に削除したり、作業項目フィールドの属性の削除、一覧表示、または変更を行ったりすることもできます。

注意

Azure DevOps Services では、 witadmin コマンドラインツールはサポートされていません。 代わりに、継承された プロセスを使用します。

次の図に示すように、各プロジェクトの作業項目のカテゴリと種類を管理します。 グローバルリスト、リンクの種類、および作業項目内のフィールドは、各プロジェクトコレクションに対して管理します。 プロジェクトまたはコレクションのグローバルワークフローをカスタマイズできます。

作業項目トラッキングオブジェクト

ヒント

Witadmin を使用すると、定義ファイルをインポートおよびエクスポートできます。 使用できるその他のツールには、プロセスエディターがあります (Visual Studio のバージョンがインストールされている必要があります)。 Visual Studio Marketplace からプロセステンプレートエディターをインストールします。

または、 TFS チームプロジェクトマネージャー(GitHub から入手できるオープンソースクライアント) を使用することもできます。

ヒント

Witadmin を使用すると、定義ファイルをインポートおよびエクスポートできます。 使用できるその他のツールには、プロセスエディターがあります (Visual Studio のバージョンがインストールされている必要があります)。 Visual Studio Marketplace から TFS プロセステンプレートエディターをインストールします。 このバージョンのプロセスエディターを使用して、旧形式の作業項目フォームを変更できます。 新しい web フォームに関連付けられているフォームを編集するために使用することはできません。

または、 TFS チームプロジェクトマネージャー(GitHub から入手できるオープンソースクライアント) を使用することもできます。

ヒント

Witadmin を使用すると、定義ファイルをインポートおよびエクスポートできます。 使用できるその他のツールには、プロセスエディターがあります (Visual Studio のバージョンがインストールされている必要があります)。 TFS パワーツールをインストールします。 または、 TFS チームプロジェクトマネージャー(GitHub から入手できるオープンソースクライアント) を使用することもできます。

ほとんどのコマンドでは、プロジェクト管理者グループまたはプロジェクトコレクション管理者グループのメンバーである必要があります。 詳細については、「 管理者の追加」を参照してください。

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

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

注意

オンプレミスのサーバーに接続する場合は、Visual Studio の同じバージョンまたはそれ以降のバージョンを使用するか、Azure DevOps Server または TFS としてチームエクスプローラーする必要があります。 たとえば、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

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

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

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

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

Visual Studio 2015 クライアント:

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

Visual Studio 2013 クライアント:

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

チームエクスプローラー2013クライアント:

cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

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

グローバル パラメーター

次のパラメーターを使用して、 witadmin のヘルプテキストを表示できます。

パラメーター 説明
/help
or
/?
Witadmin コマンドラインツールの構文とパラメーターを表示します。
コマンド/help
or
コマンド/?
指定した witadmin コマンドの構文とパラメーターを表示します。

witadmin コマンド

—、作業項目の種類 (wit)、プロセス構成、グローバルリストなどのすべての作業追跡オブジェクト — は、XML 定義によってカスタマイズされます。

すべての witadmin コマンドは、オンプレミスの TFS に対して実行できます。 作業の追跡のカスタマイズを初めて使用する場合や、でカスタマイズできる作業追跡オブジェクトの定義については、「 作業追跡エクスペリエンスのカスタマイズ」を参照してください。

作業項目の種類

  • destroywitd: WIT の削除
  • exportwitd: WIT ファイルをエクスポートする
  • importwitd: WIT ファイルをインポートする
  • listwitd: WIT 名の一覧表示
  • renamewitd: WIT の表示名を変更する

Fields

  • deletefield: フィールドを削除します。
  • listfields: List field 属性
  • indexfield: フィールドのインデックス作成を有効または無効にします。
  • changefield: フィールド属性の変更

プロセス構成

  • exportprocessconfig: ProcessConfiguration ファイルをエクスポートします。
  • importprocessconfig: ProcessConfiguration ファイルをインポートします。
  • deletelinktype: リンクの種類を削除します。
  • exportlinktype: リンクの種類のファイルをエクスポートする
  • importlinktype: リンクの種類のファイルをインポートする
  • listlinktypes: 定義されたリンクの種類を一覧表示します
  • reactivatelinktype: リンクの種類の再アクティブ化または名前変更

グローバル リスト

  • destroygloballist: グローバルリストを削除します。
  • exportgloballist: グローバルリストをエクスポートします。
  • importgloballist: グローバルリストをインポートします
  • listgloballist: すべてのグローバルリスト名を一覧表示します

グローバル ワークフロー

  • exportglobalworkflow: グローバルワークフローファイルをエクスポートします。
  • importglobalworkflow: グローバルワークフローファイルをインポートする

作業項目

  • destroywi: 作業項目を完全に削除します

クライアントキャッシュ

  • rebuildcache: クライアントキャッシュを再構築します。

Categories (カテゴリ)

  • 解決: カテゴリファイルをエクスポートする
  • importcategories: カテゴリファイルをインポートする