Proxy コマンド (Team Foundation バージョン管理)

  • [アーティクル]

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

Visual Studio 2019 | Visual Studio 2022

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

前提条件

proxy コマンドを使用してクライアント コンピューターを構成するには、ローカル コンピューターのユーザー セキュリティ グループのメンバーである必要があります。 proxy コマンドを使用してプロキシ レコードを操作するには、AdminConfiguration アクセス許可が必要です。 詳細については、セキュリティ名前空間とアクセス許可のリファレンスに関する記事を参照してください。

構文

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)

パラメーター

引数

Argument

説明

<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>

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

Options

オプション

説明

/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/

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

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