オンプレミスの Azure DevOps のクライアント キャッシュを再構築する

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

witadmin rebuildcache コマンドを使用して、次回プロジェクト コレクションに接続するときに、各クライアント コンピューターでキャッシュの再構築を強制できます。

Azure DevOps のバージョン管理またはビルド操作中にワークスペース エラーが発生しないようにするには、特定のメンテナンス操作の後にクライアント コンピューター上のデータ キャッシュを更新する必要があります。 データ層サーバーやアプリケーション層サーバーの移動、復元、名前変更、またはフェールオーバーを行った後、管理者は作業項目のトラッキングに使用されるキャッシュを更新する必要があり、ユーザーはクライアント コンピューターのバージョン管理キャッシュを更新する必要があります。

重要

サーバーのパフォーマンスに関する問題を防ぐため、通常の運用時間帯にはこのコマンドを実行しないでください。

ツールを実行するには、Visual Studio をインストールしたコマンド プロンプト ウィンドウを開き、次のように入力します。

cd %programfiles(x86)%\Microsoft Visual Studio <version>\Common7\IDE

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

要件： witadmin rebuildcache コマンドを使用するには、管理するプロジェクト コレクションの Team Foundation Administrators セキュリティ グループまたは Project Administrators セキュリティ グループのメンバーである必要があります。 Azure DevOps Serverのアクセス許可参照。

注意

管理者権限でログオンした場合でも、Windows Server 2008 を実行しているサーバーでこの機能を実行するには、管理者特権のコマンド プロンプト ウィンドウを開く必要があります。 管理者特権のコマンド プロンプト ウィンドウを開くには、[ スタート] を選択し、[ コマンド プロンプト] のショートカット メニューを開 き、[管理者として実行] を選択します。 詳細については、 Microsoft Web サイトを参照してください。

構文 :

witadmin rebuildcache /collection:CollectionURL [/noprompt]

パラメーター:

パラメーター	説明
/noprompt	確認のプロンプトを無効にします。
/? または ヘルプ	コマンド プロンプト ウィンドウにコマンドのヘルプを表示します。

備考:

witadmin rebuildcache コマンドは、指定したプロジェクト コレクションのすべてのクライアントでキャッシュされたデータを無効にします。 これにより、各クライアントのキャッシュは、クライアントが次にプロジェクト コレクションに接続するときに更新されます。

例:

次のコマンドは、AdventureWorksServer という名前のサーバーで定義されている DefaultCollection に接続するすべてのクライアントのメタデータ キャッシュを無効にします。 クライアント キャッシュは、次にプロジェクト コレクションに接続したときに更新されます。

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