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

Команда proxy (система управления версиями Team Foundation)

  • Статья

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

Visual Studio 2019 | Visual Studio 2022

Команда система управления версиями Team Foundation (TFVC) tf proxy настраивает клиентский компьютер для использования прокси-сервера. Команда добавляет, удаляет и перечисляет записи прокси-сервера о расположении и доступности одного или нескольких прокси-серверов в развертывании, включая любые удаленные сайты.

Необходимые компоненты

Чтобы использовать proxy команду для настройки клиентского компьютера, необходимо быть членом группы безопасности пользователей на локальном компьютере. Чтобы использовать proxy команду для работы с записями прокси-сервера, необходимо иметь разрешение Администратор Configuration. Дополнительные сведения см. в разделе "Пространство имен безопасности" и справочник по разрешениям.

Синтаксис

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

Description

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

Предоставляет пароль для имени пользователя.

Параметры

Параметр

Description

/configure

Настраивает клиентский компьютер для использования прокси-сервера.

/collection

Указывает коллекцию проектов.

/login

Указывает имя пользователя и пароль для проверки подлинности.

/add

Добавляет запись прокси-сервера в Azure DevOps Server о расположении и доступности прокси-серверов в сети.

/name

Связывает имя с записью прокси-сервера.

/site

Связывает домен Active Directory с записью прокси-сервера.

/description

Указывает описание записи прокси-сервера.

/default

Указывает область записи прокси-сервера. Можно указать одно из следующих значений:

  • global
  • site
  • all

Если вы добавляете запись прокси-сервера с заданным globalзначением по умолчанию, то при первом выполнении операции разработчик get azure DevOps Server перенаправляет запрос на прокси-сервер, указывающий глобальную запись. Если вы добавляете запись прокси-сервера с заданным значением siteпо умолчанию, то при первом выполнении разработчиком из указанного домена get Active Directory выполняется операция, 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/