クライアント キャッシュのリビルド [witadmin]
witadmin rebuildcache コマンドを使用すると、クライアント コンピューターが次にチーム プロジェクト コレクションに接続するときに、各クライアント コンピューター上のキャッシュを強制的にリビルドすることができます。
Team Foundation でバージョン管理操作またはビルド操作中にワークスペース エラーが発生しないようにするには、クライアント コンピューターのデータ キャッシュを、特定の保守操作の後で更新する必要があります。 データ層サーバーやアプリケーション層サーバーの移動、復元、名前変更、またはフェールオーバーを行った後、管理者は作業項目のトラッキングに使用されるキャッシュを更新する必要があり、ユーザーはクライアント コンピューターのバージョン管理キャッシュを更新する必要があります。
重要
サーバーのパフォーマンスに関する問題を防ぐため、通常の運用時間帯にはこのコマンドを実行しないでください。
witadmin コマンド ライン ツールは、オンプレミスの TFS に対して実行される場合にのみ機能します。 このツールを実行するには、Visual Studio またはチーム エクスプローラーがインストールされている環境でコマンド プロンプト ウィンドウを開き、次のように入力します。
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
32 ビット版の Windows で、%programfiles(x86)% を %programfiles% に置き換えます。
必要条件
- witadmin rebuildcache コマンドを使用するには、管理するプロジェクト コレクションの Team Foundation 管理者セキュリティ グループまたはプロジェクト管理者セキュリティ グループのメンバーである必要があります。 Team Foundation Server のアクセス許可の参照。
注意
管理者のアクセス許可を使ってログオンしている場合でも、Windows Server 2008 を実行中のサーバーでこの機能を実行するには、昇格した特権でコマンド プロンプト ウィンドウを開く必要があります。昇格した特権でコマンド プロンプト ウィンドウを開くには、[スタート] ボタンをクリックし、[コマンド プロンプト] のショートカット メニューを開いて、[管理者として実行] をクリックします。詳細については、Microsoft Web サイトを参照してください。
witadmin rebuildcache /collection:CollectionURL [/noprompt]
パラメーター
パラメーター |
説明 |
|---|---|
/collection:CollectionURL |
チーム プロジェクト コレクションの URI を指定します。 URI の形式は http://ServerName:Port/VirtualDirectoryName/CollectionName です。 仮想ディレクトリを使用していない場合、URI の形式は次のようになります。 http://ServerName:Port/CollectionName |
/noprompt |
確認のプロンプトを無効にします。 |
/? または help |
コマンド プロンプト ウィンドウにコマンドのヘルプを表示します。 |
解説
witadmin rebuildcache コマンドは、指定されたチーム プロジェクト コレクションに対して、全クライアント上でキャッシュ データを無効にします。 これにより、各クライアントのキャッシュは、クライアントが次にプロジェクト コレクションに接続するときに更新されます。
例
次のコマンドは、AdventureWorksServer という名前のサーバーで定義されている DefaultCollection に接続するすべてのクライアントのメタデータ キャッシュを無効にします。 クライアント キャッシュは、次にプロジェクト コレクションに接続したときに更新されます。
witadmin rebuildcache /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection