Proxy コマンド (TFSConfig)
TFSConfig Proxy のコマンドを使用して、Team Foundation Server Proxy に使用する設定を更新または変更できます。Team Foundation Server Proxy は、分散チームの場所にダウンロードされたコントロール ファイルのダウンロードされたバージョンのキャッシュを管理することで、分散チームによるバージョン コントロールの使用をサポートします。Team Foundation Server Proxy を構成することにより、広い範囲にわたる接続に必要な帯域幅を大幅に低減できます。バージョン ファイルのダウンロードおよびキャッシュを管理する必要もありません。ファイルを使用する開発者がファイルの管理を意識する必要はありません。一方、メタデータの交換とファイルのアップロードは、Team Foundation Server (TFS) に引き続き表示されます。Team Foundation Service を使用してクラウドの開発プロジェクトをホストする場合、プロキシ コマンドを使用してホストされているコレクション内のプロジェクトのキャッシュを管理するだけでなく、そのサービスが使用する設定の一部を管理することができます。
Team Foundation Server Proxy のインストールとプロキシの初期構成の詳細については、「方法: リモート サイトでバージョン管理ファイルをキャッシュする」を参照してください。クライアント コンピューター上でのプロキシの構成の詳細については、「Team Foundation バージョン管理コマンド リファレンス」を参照してください。
要件
Proxy コマンドを実行するには、[Team Foundation 管理者] セキュリティ グループのメンバーで、プロキシ サーバーの管理者である必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。
TFSConfig プロキシの使用
TFSConfig Proxy /add|delete|change [/Collection:TeamProjectCollectionURL /account:AccountName] /ServerURL:TeamFoundationServerURL [/Continue]
引数 |
説明 |
|---|---|
TeamProjectCollectionURL |
/Collectionで使用されます。Team Foundation Service 上でホストされる、AccountName.DomainName/CollectionName 形式のチーム プロジェクト コレクションの URL を指定します。 |
AccountName |
/Collectionで使用されます。Team Foundation Server のサービス アカウントとして使用されるアカウントの名前を指定します。アカウント名に空白が含まれる場合は、名前を二重引用符 ("") で囲む必要があります。アカウント名のすべての特殊文字は、コマンド ライン構文に従って指定する必要があります。 |
ServerURL |
/ServerURLで使用されます。ServerURL:Port/tfs 形式の TFS の配置の URL を指定します。 |
オプション |
説明 |
|---|---|
/add |
Proxy.config ファイルのプロキシ リストに指定されたサーバーまたはコレクションを追加します。/add を複数回実行して、複数のコレクションまたはサーバーを含めることができます。Team Foundation Service でホストされるコレクションで /add を使用すると、Team Foundation Service の資格情報の入力が要求されます。 |
/change |
Team Foundation Service のサービス アカウントとして格納済みの資格情報を変更します。/change オプションは、Team Foundation Service にのみ使用されます。TFS のローカル配置には使用しないでください。 |
/delete |
Proxy.config ファイルのプロキシ リストから指定されたサーバーまたはコレクションを削除します。 |
/account |
Team Foundation Service のプロキシのサービス アカウントとして使用されるアカウントを指定します。このオプションは、Team Foundation Service のみで /change オプションと一緒に使用されます。 Team Foundation Service に使用される既定のサービス アカウントは、"<cf style="Term">アカウント サービス</cf>" です。 |
/continue |
検証プロセスが警告を生成した場合でもコマンドの実行は継続されます。 |
解説
Proxy のコマンドを使用して、Team Foundation Server Proxy の既存の構成を更新します。プロキシの初期インストールと構成には、プロキシ コマンドは使用できません。
使用例
次の例では、FABRIKAM という名前の TFS 配置をプロキシ リストに追加する方法を示します。
[!メモ]
これらの例は、例示のみを目的としており、架空のものです。実際のものとは一切関係ありません。
TFSConfig Proxy /add /ServerURL:http://www.fabrikam.com:8080/tfs
次の例では、Team Foundation Service でホストされているチーム プロジェクト コレクションをプロキシ リストに追加する方法を示します。コレクションは PhoneSaver という名前で、Team Foundation のサービスで使用されるアカウント名は JillFrank.fabrikam.com です。/account オプションが指定されていないため、既定のサービス アカウントが使用されます。
TFSConfig Proxy /add /Collection:https://JillFrank.tfspreview.com/PhoneSaver
次の例では、Team Foundation Service でホストされているチーム プロジェクト コレクションのプロキシによって使用されるサービス アカウントを変更する方法を示します。コレクションは PhoneSaver という名前で、Team Foundation のサービスで使用するアカウント名は JillFrank.fabrikam.com であり、プロキシによって使用されるサービス アカウントは "<cf style="Term">My プロキシ サービス アカウント</cf>" に変更されます。アカウント名に空白が含まれているため、名前を囲むために引用符が使用されます。
TFSConfig Proxy /change /Collection:https://JillFrank.tfspreview.com/PhoneSaver /account:"My Proxy Service Account"
参照
概念
方法: リモート サイトでバージョン管理ファイルをキャッシュする