Condividi tramite

Comando proxy (controllo della versione di Team Foundation)

  • Articolo

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

Visual Studio 2019 | Visual Studio 2022

Il comando controllo della versione di Team Foundation (TFVC) tf proxy configura il computer client per l'uso di un server proxy. Il comando aggiunge, elimina ed elenca i record proxy relativi alla posizione e alla disponibilità di uno o più server proxy all'interno della distribuzione, inclusi i siti remoti.

Prerequisiti

Per usare il proxy comando per configurare un computer client, è necessario essere membri del gruppo di sicurezza Utente nel computer locale. Per usare il proxy comando per usare i record proxy, è necessario disporre dell'autorizzazione Amministrazione Configuration. Per altre informazioni, vedere Informazioni di riferimento su spazio dei nomi e autorizzazioni di sicurezza.

Sintassi

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)

Parametri

Argomenti

Argomento

Descrizione

<url>

Identifica il server proxy. È necessario usare il formato http://<proxyServerName>:<proxyPortNumber>, dove proxyServerName è il nome del server proxy e proxyPortNumber è la porta di ascolto assegnata, ad esempio http://server:8081.

<TeamProjectCollectionUrl>

Identifica la raccolta di progetti. È necessario usare il formato http://<ApplicationTierServerName>:<PortNumber>/<Directory>/<CollectionName>. dove ApplicationTierServerName è il nome del server a livello di applicazione, PortNumber è la porta di ascolto assegnata e Directory/CollectionName sono i nomi della directory e della raccolta. Ad esempio: http://server:8080/tfs/newcollection1.

<username>

Fornisce un valore all'opzione /login . È possibile specificare un valore di nome utente come DOMAIN\username o username.

<password>

Fornisce una password per il nome utente.

Opzioni

Opzione

Descrizione

/configure

Configura il computer client per l'uso di un server proxy.

/collection

Specifica la raccolta di progetti.

/login

Specifica il nome utente e la password da autenticare.

/add

Aggiunge un record proxy al server Azure DevOps sulla posizione e sulla disponibilità dei server proxy nella rete.

/name

Associa un nome a un record proxy.

/site

Associa un dominio di Active Directory a un record proxy.

/description

Specifica una descrizione del record proxy.

/default

Specifica l'ambito del record proxy. È possibile specificare uno dei seguenti valori:

  • global
  • site
  • all

Se si aggiunge un record proxy con il valore predefinito impostato su global, la prima volta che uno sviluppatore esegue un'operazione get , Azure DevOps Server reindirizza la richiesta al proxy specificato dal record globale. Se si aggiunge un record proxy con il valore predefinito impostato su site, la prima volta che uno sviluppatore dall'interno del dominio di Active Directory specificato esegue un'operazione get , Azure DevOps Server reindirizza la richiesta al proxy specificato dal record associato al sito.

/delete

Elimina un record proxy da Azure DevOps Server.

/list

Elenca i record proxy nel server Azure DevOps.

/enabled

Abilita o disabilita un proxy.

  • true
  • false

Osservazioni:

Il proxy comando ha due scopi e ogni scopo è destinato a un tipo diverso di utente.

Gli sviluppatori possono usare il comando per configurare il proxy client per l'uso di un server proxy o per eseguire l'override delle impostazioni predefinite di rete per un server proxy. Questa attività è simile alla configurazione di Azure DevOps per l'uso di un proxy.

Gli amministratori di rete possono usare il proxy comando per aggiungere e gestire record sulla posizione di vari server proxy all'interno della distribuzione di Azure DevOps Server. È possibile usare questi record per consentire agli sviluppatori di configurare le proprie workstation per l'uso di un proxy. Se si definisce un proxy globale, Azure DevOps Server può reindirizzare automaticamente gli sviluppatori per usarlo.

Se si dispone di una topologia di rete complessa con più domini di Active Directory in diverse posizioni geografiche, è possibile configurare più record e associare ogni record a un dominio specifico. Questi record possono quindi essere utili per indirizzare automaticamente gli sviluppatori da ogni posizione geografica al proxy appropriato per la propria posizione.

Per altre informazioni su come usare l'utilità della tf riga di comando, vedere Usare i comandi di controllo della versione di Team Foundation.

Esempi

L'esempio seguente rileva e configura automaticamente un computer client per l'uso di un proxy, se è stato stabilito un record proxy:

c:\projects>tf proxy /configure

L'esempio seguente esegue l'override di tutti i record proxy in Azure DevOps Server e configura un computer client per l'uso di un proxy specificato:

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

L'esempio seguente aggiunge un record globale a Azure DevOps Server sulla disponibilità del server proxy. La prima volta che uno sviluppatore esegue un'operazione get , Azure DevOps Server reindirizza tutte le richieste da tale sviluppatore al proxy specificato.

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

L'esempio seguente aggiunge un record del sito ad Azure DevOps Server per gli sviluppatori in un dominio di Active Directory, denominato corp, per usare questo server proxy. La prima volta che uno sviluppatore di tale dominio esegue un'operazione get , Azure DevOps Server reindirizza tutte le richieste da tale sviluppatore al proxy specificato.

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