Поделиться через

Команда Proxy (Team Foundation Version Control)

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Команда Управления версиями Team Foundation (TFVC) tf 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)

Параметры

Аргументы

аргумент

описание

<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 имеет две цели, и каждая цель направлена на другой тип пользователя.

В качестве разработчика можно использовать команду 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>

В следующем примере в Azure DevOps Server добавляется глобальная запись о доступности прокси-сервера server. При первом выполнении разработчиком операции get сервер Azure DevOps Server перенаправляет все запросы от этого разработчика на указанный прокси-сервер.

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

В следующем примере запись сайта добавляется в Azure DevOps Server для разработчиков в домене Active Directory с именем corp, чтобы использовать этот прокси-сервер server. При первом выполнении разработчиком из этого домена операции get сервер Azure DevOps Server перенаправляет все запросы от этого разработчика на указанный прокси-сервер.

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