Compartir a través de

Comando proxy (Control de versiones de Team Foundation)

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019

Visual Studio 2019 | de Visual Studio 2022

El comando control de versiones de Team Foundation (TFVC) tf proxy configura el equipo cliente para usar un servidor proxy. El comando agrega, elimina y enumera los registros de proxy sobre la ubicación y disponibilidad de uno o varios servidores proxy dentro de la implementación, incluidos los sitios remotos.

Prerrequisitos

Para usar el comando para configurar un equipo cliente, sea miembro del grupo de seguridad usuario de en el equipo local. Para usar el comando proxy para trabajar con registros proxy, tenga el permiso AdminConfiguration. Para obtener más información, consulte Referencia de permisos y espacio de nombres de seguridad.

Sintaxis

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)

Parámetros

Argumentos

de argumentos de

descripción

<url>

Identifica el servidor proxy. Debe usar el formato http://<proxyServerName>:<proxyPortNumber>, donde proxyServerName es el nombre del servidor proxy y proxyPortNumber es el puerto de escucha asignado, por ejemplo, http://server:8081.

<TeamProjectCollectionUrl>

Identifica la colección de proyectos. Debe usar el formato http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>. donde ApplicationTierServerName es el nombre del servidor de nivel de aplicación, PortNumber es el puerto de escucha asignado y Directory/CollectionName son los nombres del directorio y la colección. Por ejemplo, http://server:8080/tfs/newcollection1.

<username>

Proporciona un valor a la opción /login. Puede especificar un valor de nombre de usuario como DOMAIN\username o username.

<password>

Proporciona una contraseña para el nombre de usuario.

Opciones

de opción de

descripción

/configure

Configura el equipo cliente para usar un servidor proxy.

/collection

Especifica la colección de proyectos.

/login

Especifica el nombre de usuario y la contraseña que se van a autenticar.

/add

Agrega un registro de proxy a Azure DevOps Server sobre la ubicación y la disponibilidad de los servidores proxy en la red.

/name

Asocia un nombre a un registro proxy.

/site

Asocia un dominio de Active Directory a un registro proxy.

/description

Especifica una descripción del registro proxy.

/default

Especifica el ámbito del registro proxy. Puede especificar uno de los siguientes valores:

  • global
  • site
  • all

Si agrega un registro de proxy con el valor predeterminado establecido en global, la primera vez que un desarrollador realiza una operación de get, Azure DevOps Server redirige esa solicitud al proxy que especifica el registro global. Si agrega un registro de proxy con el valor predeterminado establecido en site, la primera vez que un desarrollador desde el dominio de Active Directory especificado realiza una operación de get, Azure DevOps Server redirige esa solicitud al proxy que especifica el registro asociado al sitio.

/delete

Elimina un registro de proxy de Azure DevOps Server.

/list

Enumera los registros de proxy en el servidor de Azure DevOps.

/enabled

Habilita o deshabilita un proxy.

  • true
  • false

Observaciones

El comando proxy tiene dos propósitos y cada propósito tiene como objetivo un tipo de usuario diferente.

Como desarrollador, puede usar el comando proxy para configurar el cliente para que use un servidor proxy o para invalidar los valores predeterminados de red para un servidor proxy. Esta tarea es similar a la configuración de Azure DevOps para usar un proxy.

Como administrador de red, puede usar el comando proxy para agregar y administrar registros sobre la ubicación de varios servidores proxy dentro de la implementación de Azure DevOps Server. Puede usar estos registros para ayudar a los desarrolladores a configurar sus estaciones de trabajo para que usen un proxy. Si define un proxy global, Azure DevOps Server puede redirigir automáticamente a los desarrolladores para que lo usen.

Si tiene una topología de red compleja con varios dominios de Active Directory en varias ubicaciones geográficas, puede configurar varios registros y asociar cada registro a un dominio determinado. Estos registros pueden ayudarle a dirigir automáticamente a los desarrolladores de cada ubicación geográfica al proxy adecuado para su ubicación.

Para obtener más información sobre cómo usar la utilidad de línea de comandos de tf, consulte Usar comandos de control de versiones de Team Foundation.

Ejemplos

En el ejemplo siguiente se detecta y configura automáticamente un equipo cliente para usar un proxy, si se ha establecido un registro proxy:

c:\projects>tf proxy /configure

En el ejemplo siguiente se invalidan los registros de proxy en Azure DevOps Server y se configura un equipo cliente para usar un proxy especificado:

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

En el ejemplo siguiente se agrega un registro global a Azure DevOps Server sobre la disponibilidad del proxy de server. La primera vez que un desarrollador realiza una operación de get, Azure DevOps Server redirige todas las solicitudes de ese desarrollador al proxy especificado.

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

En el ejemplo siguiente se agrega un registro de sitio a Azure DevOps Server para desarrolladores de un dominio de Active Directory, denominado corp, para usar este proxy server. La primera vez que un desarrollador de ese dominio realiza una operación de get, Azure DevOps Server redirige todas las solicitudes de ese desarrollador al proxy especificado.

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