次の方法で共有

Proxy コマンド (Team Foundation バージョンコントロール)

  • [アーティクル]

Azure DevOps Services の |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation Version Control (TFVC) tf proxy コマンドは、プロキシ サーバーを使用するようにクライアント コンピューターを構成します。 このコマンドは、リモート サイトを含む、展開内の 1 つ以上のプロキシ サーバーの場所と可用性に関するプロキシ レコードを追加、削除、および一覧表示します。

前提 条件

proxy コマンドを使用してクライアント コンピューターを構成するには、ローカル コンピューターの User セキュリティ グループのメンバーになります。 proxy コマンドを使用してプロキシ レコードを操作するには、AdminConfiguration アクセス許可を持ちます。 詳細については、「Security 名前空間とアクセス許可のリファレンス」を参照してください。

構文

tf proxy ([/configure [Url]) [/collection:TeamProjectCollectionUrl]
[/login:UserName,[Password]]

tf proxy /add Url [/name:Name] [/site:SiteName] 
[/description:Description] [/default:(global|site|all)] 
[/collection:TeamProjectCollectionUrl] [/login:UserName,[Password]] 

tf proxy /delete Url [/collection:TeamProjectCollectionUrl]
[/login:UserName,[Password]] 

tf proxy /list [Url1 Yrl2 ...] 
[/collection:TeamProjectCollectionUrl] [/login:UserName,[Password]]

tf proxy /enabled:(true|false)

パラメーター

引数

引数の

説明

<url>

プロキシ サーバーを識別します。 http://<proxyServerName>:<proxyPortNumber>形式を使用する必要があります。ここで、proxyServerName はプロキシ サーバーの名前、proxyPortNumber は割り当てられたリッスン ポートです (たとえば、http://server:8081)。

<TeamProjectCollectionUrl>

プロジェクト コレクションを識別します。 http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>形式を使用する必要があります。 ここで、ApplicationTierServerName はアプリケーション層サーバーの名前、PortNumber は割り当てられたリッスン ポート、Directory/CollectionName はディレクトリとコレクションの名前です。 たとえば、http://server:8080/tfs/newcollection1します。

<username>

/login オプションに値を提供します。 ユーザー名の値は、DOMAIN\username または usernameとして指定できます。

<password>

ユーザー名のパスワードを指定します。

オプション

オプションの

説明

/configure

プロキシ サーバーを使用するようにクライアント コンピューターを構成します。

/collection

プロジェクト コレクションを指定します。

/login

認証するユーザー名とパスワードを指定します。

/add

ネットワーク上のプロキシ サーバーの場所と可用性に関するプロキシ レコードを Azure DevOps Server に追加します。

/name

名前をプロキシ レコードに関連付けます。

/site

Active Directory ドメインをプロキシ レコードに関連付けます。

/description

プロキシ レコードの説明を指定します。

/default

プロキシ レコードのスコープを指定します。 次のいずれかの値を指定できます。

  • global
  • site
  • all

既定が globalに設定されたプロキシ レコードを追加した場合、開発者が初めて get 操作を実行すると、Azure DevOps Server はその要求をグローバル レコードが指定するプロキシにリダイレクトします。 既定が siteに設定されたプロキシ レコードを追加すると、指定した Active Directory ドメイン内の開発者が初めて get 操作を実行すると、Azure DevOps Server は、サイトに関連付けられているレコードが指定したプロキシにその要求をリダイレクトします。

/delete

Azure DevOps Server からプロキシ レコードを削除します。

/list

Azure DevOps サーバーのプロキシ レコードを一覧表示します。

/enabled

プロキシを有効または無効にします。

  • true
  • false

備考

proxy コマンドには 2 つの目的があり、それぞれの目的は異なる種類のユーザーを対象としています。

開発者は、proxy コマンドを使用して、プロキシ サーバーを使用するようにクライアントを構成したり、プロキシ サーバーのネットワークの既定値をオーバーライドしたりできます。 このタスクは、プロキシを使用するように Azure DevOps を構成するのと似ています。

ネットワーク管理者は、proxy コマンドを使用して、Azure DevOps Server のデプロイ内のさまざまなプロキシ サーバーの場所に関するレコードを追加および管理できます。 これらのレコードを使用すると、開発者がプロキシを使用するようにワークステーションを構成するのに役立ちます。 グローバル プロキシを定義すると、Azure DevOps Server は開発者を自動的にリダイレクトして使用できます。

さまざまな地理的な場所に複数の Active Directory ドメインがある複雑なネットワーク トポロジがある場合は、複数のレコードを設定し、各レコードを特定のドメインに関連付けることができます。 これらのレコードは、各地理的な場所から、その場所に適したプロキシに開発者を自動的に誘導するのに役立ちます。

tf コマンドライン ユーティリティの使用方法の詳細については、「Team Foundation バージョン管理コマンドを使用する」を参照してください。

例

次の例では、プロキシ レコードが確立されている場合に、プロキシを使用するようにクライアント コンピューターを自動的に検出して構成します。

c:\projects>tf proxy /configure

次の例では、Azure DevOps Server 上のすべてのプロキシ レコードをオーバーライドし、指定したプロキシを使用するようにクライアント コンピューターを構成します。

c:\projects>tf proxy /configure <Url>

次の例では、server プロキシの可用性に関するグローバル レコードを Azure DevOps Server に追加します。 開発者が初めて get 操作を行う場合、Azure DevOps Server は、その開発者から指定されたプロキシにすべての要求をリダイレクトします。

c:\projects>tf proxy /add http://server:8081 /default:global /collection:http://tfsserver:8080/

次の例では、この server プロキシを使用するために、corpという名前の Active Directory ドメインの開発者向けに、Azure DevOps Server にサイト レコードを追加します。 そのドメインの開発者が初めて get 操作を行う場合、Azure DevOps Server は、その開発者から指定されたプロキシにすべての要求をリダイレクトします。

c:\projects>tf proxy /add http://server:8081 /default:site /site:corp /collection:http://tfsserver:8080/