Comando proxy (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | Visual Studio 2022

El comando tf proxy de Control de versiones de Team Foundation (TFVC) configura el equipo cliente para usar un servidor proxy. El comando agrega, elimina y muestra una lista de 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.

Requisitos previos

Para usar el comando proxy a fin de configurar un equipo cliente, debe ser miembro del grupo de seguridad Usuario en el equipo local. Para usar el comando proxy a fin de trabajar con registros proxy, debe tener el permiso AdminConfiguration. Para obtener más información, vea 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

Argument

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

Opción

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 de proxy.

/site

Asocia un dominio de Active Directory a un registro de proxy.

/description

Especifica una descripción del registro de proxy.

/default

Especifica el ámbito del registro de 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 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 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

Muestra una lista de 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 uno de ellos está dirigido a un tipo diferente de usuario.

Como desarrollador, puede usar el comando proxy para configurar el cliente a fin de que use un servidor proxy o invalide los valores predeterminados de red de 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 a fin de 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 uno de ellos a un dominio determinado. Estos registros pueden ayudarle a dirigir automáticamente a los desarrolladores de cada ubicación geográfica al proxy adecuado según su ubicación.

Para obtener más información sobre cómo usar la utilidad de línea de comandos tf, vea Uso de 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 server. La primera vez que un desarrollador realiza una operación 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 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/