Usare TFSConfig per gestire Azure DevOps in locale

Azure DevOps Server |Azure DevOps Server |Azure DevOps Server 2022 | Azure DevOps Server 2020

È possibile usare lo strumento da riga di comando TFSConfig per eseguire un'ampia gamma di azioni amministrative per la distribuzione locale di Azure DevOps.

TFSConfig può essere eseguito da qualsiasi computer in cui è stato installato Azure DevOps Server.

Posizione degli strumenti da riga di comando

Gli strumenti da riga di comando di Azure DevOps vengono installati nella directory /Tools di un server livello applicazione Azure DevOps.

Azure DevOps Server 2020: %programfiles%\Azure DevOps Server 2020\Tools
Azure DevOps Server 2019: %programfiles%\Azure DevOps Server 2019\Tools
TFS 2018: %programfiles%\Microsoft Team Foundation Server 2018\Tools
TFS 2017: %programfiles%\Microsoft Team Foundation Server 15.0\Tools
TFS 2015: %programfiles%\Microsoft Team Foundation Server 14.0\Tools
TFS 2013: %programfiles%\Microsoft Team Foundation Server 12.0\Tools
TFS 2012: %programfiles%\Microsoft Team Foundation Server 11.0\Tools
TFS 2010: %programfiles%\Microsoft Team Foundation Server 2010\Tools

Prerequisiti

Per il corretto funzionamento di molti comandi, TFSConfig dovrà essere in grado di connettersi ai vari server e servizi che fanno parte della distribuzione TFS e l'utente che esegue TFSConfig dovrà avere autorizzazioni amministrative per questi stessi server e servizi. I requisiti per comandi specifici verranno indicati di seguito.

Molti comandi TFSConfig devono essere eseguiti da un prompt dei comandi con privilegi elevati, anche se l'utente in esecuzione dispone di credenziali amministrative. Per aprire un prompt dei comandi con privilegi elevati, fare clic su Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e quindi scegliere Esegui come amministratore. Per altre informazioni, vedere Controllo dell'account utente.

È anche possibile eseguire azioni amministrative in modo interattivo usando la console di amministrazione per Azure DevOps Server. Vedere Informazioni di riferimento rapido sulle attività amministrative.

Elenca i comandi e ottieni aiuto

Per visualizzare un elenco completo dei comandi TFSConfig, usare il comando help :

TFSConfig help

Per ottenere assistenza per un singolo comando, usare il comando della Guida e specificare il nome del comando con cui si vuole ottenere assistenza. Ad esempio, per ottenere assistenza per il comando accounts :

TFSConfig help accounts

Gli account

Usare il comando accounts per gestire questi account del servizio Azure DevOps Server.

account di servizio di Azure DevOps Server
l'account delle origini dati per SQL Server Reporting Services
l'account del servizio server proxy di Azure DevOps

È anche possibile usare questo comando per modificare la proprietà dei database di Azure DevOps Server.

TfsConfig accounts /change|add|set|delete|updatepassword|resetowner
	[/accountType:<adminConsole|applicationTier|proxy|reportingDataSource>]
	[/account:<accountName>] [/password:<password>]
	[/sqlInstance:<serverName>] [/databaseName:<databaseName>] [/continue]

Operazione	Descrizione
AggiornaPassword	Modifica la password di un account usato come account del servizio. Modifica l'account esistente e tutti i tipi di account che operano come l'account specificato.
Cambiamento	Modifica l'account usato come account di servizio. Aggiunge il nuovo account alle risorse e ai gruppi necessari, concede le autorizzazioni necessarie, quindi imposta il servizio per usarlo. Questo non rimuove l'account precedente dalle risorse. Se non si usa l'opzione accountType , l'account del servizio per il livello applicazione verrà modificato.
Aggiungere	Aggiunge solo il nuovo account alle risorse necessarie. Utile per gli scenari di Bilanciamento del carico di rete. Usare il flag "Continue" se alcune raccolte non sono raggiungibili. Aggiungere può essere eseguito di nuovo in un secondo momento per aggiornare eventuali raccolte perse. Aggiunge un account ai gruppi necessari per utilizzare l'account come account di servizio.
Impostare	Imposta il servizio per utilizzare solo un account già aggiunto alle risorse. Utile per gli scenari di Bilanciamento del carico di rete.
Cancella	Rimuove l'account da tutte le risorse. È consigliabile usare precauzioni quando si elimina un account perché può causare la negazione del servizio da parte di altri server.
ResetOwner	Se i database vengono ripristinati come parte di uno spostamento, clonazione o ripristino di emergenza, il proprietario del database può passare all'amministratore che ripristina il server. Questa opzione itera su tutti i database e imposta il login dbo al proprietario corrente.

Tipo di Account	Descrizione
AdminConsole	Gli utenti della Console di amministrazione sono utenti a cui sono state concesse le autorizzazioni minime per varie risorse per l'uso della console.
ApplicationTier	Modifica l'account del servizio sull'appPool per i servizi web principali. (TFSService)
Intermediario	Modifica l'account del servizio nell'appPool per i servizi Web proxy. (TFSProxy)
ReportingDataSource	Cambia l'account che i report utilizzano per accedere ai dati di reportistica. (TFSReports)

Il valore predefinito è ApplicationTier.

SqlInstance e databaseName sono appropriati solo per l'aggiunta di un account ai database prima della configurazione del livello applicazione. Ciò è particolarmente utile negli scenari di ripristino di emergenza in cui è necessario un altro account prima di eseguire la configurazione guidata solo AT.

L'opzione continue viene usata durante l'aggiunta o la modifica di un account. Per tali operazioni, l'account viene modificato in ogni database di raccolta. Se viene fornita l'opzione di continuare, continuerà se una raccolta è irraggiungibile. Può essere eseguito di nuovo quando sono raggiungibili.

Nota

Gli account devono essere in formato domainName\userName. Per gli account di sistema, è necessario usare le virgolette relative al nome completo dell'account( ad esempio "NT Authority\Network Service"). Gli account di sistema non richiedono una password.

Parametro	Descrizione
Conto	Specifica il nome dell'account che si desidera aggiungere, modificare o eliminare da un tipo di account a cui si fa riferimento, ad esempio /AccountType:ApplicationTier.
parola chiave	Specifica la password dell'account del servizio. Questo parametro è facoltativo se si usa un account di sistema o un account che non dispone di una password, ad esempio servizio di rete.
sqlInstance	Usato solo con /ResetOwner. Specifica il nome del server che esegue SQL Server e il nome dell'istanza se si desidera utilizzare un'istanza diversa dall'istanza predefinita. È necessario specificare il nome e l'istanza nel formato seguente: NomeServer\NomeIstanza.
nomeDelDatabase	Usato solo con /ResetOwner. Specifica il nome del database di cui si desidera modificare la proprietà. Usando questo comando, si reimposta la proprietà del database specificato nell'account con cui si esegue il comando.
continuare	Aggiorna tutti i gruppi che non sono disponibili quando si esegue il comando . Questa opzione viene solitamente utilizzata negli scenari di bilanciamento del carico di rete.

Prerequisiti

Per usare il comando accounts , è necessario essere membri di:

gruppo di sicurezza Azure DevOps Administrators
ruolo sysadmin per tutte le istanze di SQL Server usate dall'istanza di Azure DevOps Server.

Se si usa l'opzione /proxy , è necessario essere un amministratore nel server proxy.

Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Osservazioni:

Usare il comando accounts per automatizzare le modifiche apportate agli account, ai database e ai gruppi di account del servizio di Azure DevOps Server. È possibile configurare gli account già creati, ma non è possibile creare account.

Prima di modificare il dominio o il gruppo di lavoro di un account, l'account deve avere l'autorizzazione "Account sensibile e non delegabile" sul server di livello applicazione. Per altre informazioni, vedere questa pagina nel sito Web Microsoft: Abilitazione dell'autenticazione delegata.

Il comando accounts supporta le distribuzioni locali di Azure DevOps Server. Per modificare il proprietario dell'account di un account Azure DevOps Services, vedere Modificare la proprietà dell'account.

Esempi

Modificare l'account di servizio delle origini dati per Reporting Services con un nuovo account nel dominio Contoso, Contoso\NewAccount, e la password in Password.

TfsConfig accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password

Aggiungere l'account di sistema del servizio di rete ai gruppi di account del servizio per Azure DevOps Server (gli account di sistema non hanno password).

TfsConfig accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

Modifica la proprietà del database TFS_Warehouse sul server SQL ContosoMain nell'istanza denominata TeamDatabases, usando l'account utente con cui esegui il comando.

Nota

Non è possibile specificare l'account da impostare come proprietario dei database quando si usa questo comando. Il proprietario verrà impostato sull'account con cui si esegue il comando.

TfsConfig accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse

AggiungiRapportiProgetto

Nota

Il comando addProjectReports è disponibile con TFS 2017.1 e versioni successive.

Usare il comando addProjectReports per aggiungere o sovrascrivere report per un progetto team esistente.

TfsConfig addProjectReports /collection:<teamProjectCollectionUrl> /teamProject:<projectName> /template:<templateName>
[/force]

Opzione	Descrizione
collezione	Obbligatorio. URL della raccolta di progetti del team.
progetto di squadra	Obbligatorio. Specifica il nome del progetto del team.
modello	Obbligatorio. Specifica il nome del modello di processo. Le opzioni disponibili sono Agile, CMMI e Scrum.
forza	Opzionale. Specifica che i report devono essere sovrascritti se esistono già.

Prerequisiti

Per usare il comando addProjectReports, è necessario disporre delle autorizzazioni necessarie per eseguire TFSConfig e caricare report nel servizio Reporting.

Osservazioni:

Usare il comando addProjectReports quando il progetto non dispone di report o si desidera aggiornare i report definiti per un processo.

Potrebbe essere necessario usare questo comando quando:

Il progetto è stato creato nel portale di Azure DevOps e non da Visual Studio
Il progetto è stato creato da Visual Studio, ma la creazione di report non è stata configurata in Azure DevOps Server.

Se si desidera sovrascrivere i report nel progetto con report predefiniti perché è stato aggiornato Azure DevOps Server e i report precedenti nel progetto non sono più compatibili, usare l'opzione /force . Se sono stati personalizzati i report, eseguire un backup prima di eseguire questa operazione.

Per altre informazioni sull'aggiunta di report a un server Azure DevOps locale, vedere Aggiungere report a un progetto.

Esempio

Nell'esempio seguente viene illustrato come aggiungere report Agile al MyProject progetto nella http://myTfsServer:8080/tfs/DefaultCollection raccolta di progetti.

TFSConfig addProjectReports /collection:http://myTfsServer:8080/tfs/DefaultCollection /teamproject:MyProject /template:Agile

Autenticazione

Il comando Authentication modifica il protocollo di autenticazione di rete usato dal livello applicazione o dal sito Web proxy di Azure DevOps Server.

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]

Opzione

Descrizione

/viewAll

Visualizza le impostazioni di autenticazione correnti per Azure DevOps Server.

/provider: { NTLM | Negotiate }

Specifica il provider di autenticazione da configurare per il sito Web.

NTLM: usare il protocollo di autenticazione NTML
Negotiate: usare il protocollo di autenticazione Negotiate (Kerberos)

/siteType

Specifica il sito Web (livello applicazione o proxy) il cui protocollo di autenticazione di rete si vuole modificare. Il livello applicazione è l'impostazione predefinita.

Prerequisiti

Per usare il comando Authentication , è necessario essere un membro del gruppo di sicurezza Azure DevOps Administrators e un amministratore locale nel server del livello applicazione o del server proxy, a seconda del valore dell'opzione siteType .

Osservazioni:

Il comando Authentication viene usato da un amministratore che vuole modificare il protocollo di autenticazione di rete per uno o più siti Web su cui si basa Azure DevOps Server. L'amministratore esegue questo comando dal livello applicazione per aggiornare i siti Web che richiedono una modifica nel protocollo di autenticazione di rete. Il comando modifica la proprietà NTAuthenticationProviders nella metabase IIS.

Prima di usare il comando Authentication per modificare il protocollo di autenticazione, è possibile eseguire il comando con l'opzione /viewAll per vedere quali sono le impostazioni esistenti.

Esempio

Nell'esempio seguente viene visualizzato il valore corrente assegnato per il protocollo di autenticazione di rete.

TFSConfig Authentication /viewAll

Certificati

Usare il comando certificates per modificare la configurazione dei certificati per l'autenticazione client in una distribuzione di Azure DevOps Server che usa HTTPS, secure sockets layer (SSL) e certificati.

TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]

Opzione	Descrizione
macchina	Specifica che l'elenco di certificati proviene dal contesto del computer locale anziché dal contesto utente corrente.
disabilitare	Specifica che l'impostazione del certificato di autenticazione client verrà disabilitata.
selezione automatica	Specifica che un certificato verrà selezionato automaticamente dall'elenco dei certificati. La finestra Gestisci certificati client non verrà aperta.
noprompt	Specifica che la finestra Gestisci certificati client non verrà aperta quando viene eseguito il comando Certificati.
impronte digitali del pollice	Specifica che verrà utilizzato il certificato che corrisponde all'impronta digitale specificata. È possibile specificare più certificati separando le singole identificazioni personali con una virgola.

Prerequisiti

Per usare il comando certificates , è necessario essere membri del gruppo di sicurezza Azure DevOps Administrators e del gruppo Administrators locale nel computer da cui si esegue il comando. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Osservazioni:

Per impostazione predefinita, il comando certificates selezionerà automaticamente un certificato client dall'elenco di certificati per l'utente corrente. Tuttavia, è possibile usare le opzioni per il comando per specificare un certificato o certificati specifici dal contesto utente corrente o dal contesto del computer locale.

Prima di usare il comando certificates , è necessario configurare i server nella distribuzione di Azure DevOps Server per usare i certificati. Per altre informazioni, vedere Configurazione di HTTPS con SECURE Sockets Layer (SSL) per Azure DevOps Server.

Usare il comando certificates per configurare i certificati client usati da una distribuzione di Azure DevOps Server configurata per l'uso di HTTPS/SSL e certificati. Se si usa il comando Certificati senza opzioni, un certificato client verrà selezionato automaticamente dal contesto utente corrente da cui si esegue il comando.

Esempi

Nell'esempio seguente viene illustrato come specificare il certificato del computer locale che ha l'impronta digitale aa bb cc dd ee senza richiesta di conferma.

TfsConfig certificates /machine /thumbprint:aa bb cc dd ee /noprompt

Nell'esempio seguente viene illustrato come specificare l'uso della selezione automatica di un certificato client dall'archivio utente corrente.

TfsConfig certificates /autoselect

ChangeServerID

Il comando changeServerID modifica i GUID associati ai database per Azure DevOps Server. I GUID devono essere univoci all'interno di una distribuzione di Azure DevOps Server. Se più database hanno lo stesso GUID, la distribuzione può diventare instabile o inutilizzabile. È possibile modificare il GUID per il database di configurazione, i GUID per tutti i database della raccolta di progetti nella distribuzione o entrambi.

Anche se in genere non si usa questo comando nelle operazioni quotidiane, è possibile usare questo comando nelle circostanze seguenti:

La distribuzione è stata ripristinata in un nuovo hardware, la distribuzione precedente è ancora operativa e si vogliono usare entrambe le distribuzioni. Questo scenario viene talvolta definito clonazione del server.
Si vuole testare un aggiornamento software o una configurazione hardware in una distribuzione duplicata in modo da non compromettere l'ambiente di produzione.
Si vuole testare completamente il ripristino dei database in un nuovo hardware in un lab di test o in un ambiente separato, per assicurarsi che la distribuzione possa essere ripristinata.
È necessario reimpostare il GUID per un database di raccolta dopo averlo spostato in un'altra distribuzione per cui tale GUID è già riservato.

Nota

Il comando changeServerID non è reversibile. Dopo la modifica di un GUID, non è possibile annullare tale modifica tranne ripristinando una versione precedente del database.

TfsConfig changeServerID /sqlInstance:<serverName> /databaseName:<configurationDatabaseName>
	[/projectCollectionsOnly] [/configDBOnly] [/collectionName]

Opzione	Descrizione
sqlInstance	Obbligatorio. Specifica il nome del server che esegue SQL Server e il nome dell'istanza se si desidera utilizzare un'istanza diversa dall'istanza predefinita. Se si specifica un'istanza, è necessario usare il formato: `ServerName\InstanceName`.
nomeDelDatabase	Obbligatorio. Specifica il nome del database di configurazione per Azure DevOps Server. Per impostazione predefinita, il nome del database è TFS_ConfigurationDB.
progettoCollezioniSolo	Specifica che verranno modificati solo i GUID per le raccolte.
configDBOnly	Specifica che verrà modificato solo il GUID per il database di configurazione.
nome collezione	Specifica di creare un nuovo ID istanza per la raccolta specifica, ma non per l'istanza di Azure DevOps e le altre raccolte.

Prerequisiti

Per usare il comando changeServerID , è necessario essere membri del gruppo di sicurezza Azure DevOps Administrators e membro del ruolo di sicurezza sysadmin per tutte le istanze di SQL Server usate da Azure DevOps Server. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps.

Osservazioni:

Usare il comando changeServerID per creare un duplicato discreto di una distribuzione di Azure DevOps Server per scopi di test o clonazione. Dopo aver usato il comando changeServerID , è necessario indirizzare i client a creare una connessione al server modificato prima di poterlo usare.

Esempio

L'esempio seguente illustra come modificare i GUID di tutti i database nella distribuzione Contoso1 di Azure DevOps Server, in cui il database di configurazione è ospitato nel server denominato ContosoMain nell'istanza TeamDatabases denominata in SQL Server.

TfsConfig changeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

Indice di Codice

Usare il comando codeIndex per gestire l'indicizzazione del codice in Azure DevOps Server. Ad esempio, è possibile reimpostare l'indice per correggere le informazioni di CodeLens o disattivare l'indicizzazione per analizzare i problemi di prestazioni del server.

TfsConfig codeIndex /indexingStatus | /setIndexing:[on|off|keepupOnly] |
	/ignoreList:[ add | remove | removeAll | view ] <serverPath> |
	/listLargeFiles [/fileCount:FileCount] [/minSize:MinSize] |
	/reindexAll | 
    /destroyCodeIndex [/noPrompt] |
	/temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] |
	/indexHistoryPeriod:[ view | all | <NumberOfMonths> ] [/collectionName:<collectionName> | /collectionId:<collectionId>]

Opzione	Descrizione
stato di indicizzazione	Visualizzare lo stato e la configurazione del servizio di indicizzazione del codice.
impostareIndicizzazione	on: avviare l'indicizzazione di tutti i set di modifiche. off: arrestare l'indicizzazione di tutti i set di modifiche. keepupOnly: interrompere l'indicizzazione dei set di modifiche creati in precedenza e avviare l'indicizzazione solo di nuovi insiemi di modifiche.
ignoreList	Specifica un elenco di file di codice e i relativi percorsi che non si desidera indicizzare. add: aggiungere il file che non si vuole indicizzare all'elenco di file ignorati. remove: rimuovere il file da indicizzare dall'elenco di file ignorato. removeAll: cancella l'elenco di file ignorato e avvia l'indicizzazione di tutti i file. view: visualizza tutti i file che non vengono indicizzati. ServerPath: specifica il percorso di un file di codice. È possibile usare il carattere jolly (*) all'inizio, alla fine o a entrambe le estremità del percorso del server.
listLargeFiles	Mostra il numero specificato di file che superano le dimensioni specificate in KB. È quindi possibile usare l'opzione /ignoreList per escludere questi file dall'indicizzazione. A questo scopo, è necessario Team Foundation Server 2013 con Update 3.
reindexAll	Cancellare i dati indicizzati in precedenza e riavviare l'indicizzazione.
distruggiIndiceCodice	Eliminare l'indice del codice e rimuovere tutti i dati indicizzati. Non richiede conferma se si usa l'opzione /noPrompt .
temporaryDataSizeLimit	Controllare la quantità di dati temporanei creati da CodeLens durante l'elaborazione di insiemi di modifiche. Il limite predefinito è 6 GB (2 GB nell'aggiornamento 5). view: mostra il limite di dimensioni corrente. SizeInGBs: modificare il limite di dimensioni. Disabilita: Rimuovi il limite di dimensioni. Questo limite viene controllato prima che CodeLens elabori un nuovo insieme di modifiche. Se i dati temporanei superano questo limite, CodeLens sospende l'elaborazione dei set di modifiche precedenti, non quelli nuovi. CodeLens riavvia l'elaborazione dopo la pulizia dei dati e scende al di sotto di questo limite. La pulizia viene eseguita automaticamente una volta al giorno. Ciò significa che i dati temporanei potrebbero superare questo limite fino all'avvio della pulizia. A questo scopo, è necessario Team Foundation Server 2013 con l'aggiornamento 4.
periodoDiStoriaDellIndice	Controllare per quanto tempo indicizzare la cronologia delle modifiche. Questo influisce sulla quantità di cronologia mostrata da CodeLens. Il limite predefinito è 12 mesi. Questo significa che CodeLens mostra solo la cronologia delle modifiche degli ultimi 12 mesi. view: mostra il numero corrente di mesi. all: indicizzare tutta la cronologia delle modifiche. NumberOfMonths: modificare il numero di mesi usati per indicizzare la cronologia delle modifiche. A questo scopo, è necessario Team Foundation Server 2013 con l'aggiornamento 4.
nome collezione	Specifica il nome della raccolta di progetti in cui eseguire il comando CodeIndex . Obbligatorio se non si usa /CollectionId.
Identificativo della collezione	Specifica il numero di identificazione della raccolta di progetti in cui eseguire il comando CodeIndex . Obbligatorio se non si usa /CollectionName

Prerequisiti

Per usare il comando codeIndex , è necessario essere un membro del gruppo di sicurezza Azure DevOps Administrators. Vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Esempi

Per visualizzare lo stato e la configurazione dell'indicizzazione del codice:

TfsConfig codeIndex /indexingStatus /collectionName:"Fabrikam Web Site"

Per avviare l'indicizzazione di tutti i set di modifiche:

TfsConfig codeIndex /setIndexing:on /collectionName:"Fabrikam Web Site"

Per interrompere l'indicizzazione dei set di modifiche creati in precedenza e avviare l'indicizzazione solo di nuovi insiemi di modifiche:

TfsConfig codeIndex /setIndexing:keepupOnly /collectionName:"Fabrikam Web Site"

Per trovare fino a 50 file di dimensioni superiori a 10 KB:

TfsConfig codeIndex /listLargeFiles /fileCount:50 /minSize:10 /collectionName:"Fabrikam Web Site"

Per escludere un file specifico dall'indicizzazione e aggiungerlo all'elenco di file ignorati:

TfsConfig codeIndex /ignoreList:add "$/Fabrikam Web Site/Catalog.cs" /collectionName:"Fabrikam Web Site"

Per visualizzare tutti i file non indicizzati:

TfsConfig codeIndex /ignoreList:view

Per cancellare i dati indicizzati in precedenza e riavviare l'indicizzazione:

TfsConfig codeIndex /reindexAll /collectionName:"Fabrikam Web Site"

Per salvare tutta la cronologia del set di modifiche:

TfsConfig codeIndex /indexHistoryPeriod:all /collectionName:"Fabrikam Web Site"

Per rimuovere il limite di dimensioni per i dati temporanei codeLens e continuare l'indicizzazione indipendentemente dalle dimensioni temporanee dei dati:

TfsConfig codeIndex /temporaryDataSizeLimit:disable /collectionName:"Fabrikam Web Site"

Per eliminare l'indice del codice con conferma:

TfsConfig codeIndex /destroyCodeIndex /collectionName:"Fabrikam Web Site"

Raccolta

È possibile usare il comando raccolta per collegare, scollegare o eliminare una raccolta di progetti da una distribuzione di Azure DevOps Server. È anche possibile usare il comando raccolta per duplicare il database di una raccolta esistente, rinominarlo e collegarlo alla distribuzione. Questo processo viene talvolta definito clonazione di una raccolta.

TfsConfig collection {/attach | /create | /detach | /delete} [/collectionName:<collectionName>]
    [/description:<collectionDescription>]
    [/collectionDB:<serverName>;<databaseName>]
    [/processModel:Inheritance|Xml]
    [/reportingFolder:<reportingFolderPath>]
    [/clone] [/verify] [/continue]

Opzione	Descrizione
allegare	Obbligatorio se non viene usato /detach né /delete . Se si specifica questa opzione, è necessario usare anche l'opzione /collectionDB . Come opzione, è anche possibile usare /collectionName e /clone con questa opzione. Se si usa l'opzione /attach , il database di raccolta specificato verrà aggiunto alla distribuzione di Azure DevOps Server.
creare	Crea una raccolta.
staccare	Obbligatorio se non viene usato /attach né /delete . Se si specifica questa opzione, è necessario usare anche l'opzione /collectionName . Se si usa l'opzione /detach , il database per la raccolta specificata verrà arrestato e la raccolta verrà scollegata dalla distribuzione di Azure DevOps Server.
eliminare	Obbligatorio se non viene usato /detach né /attach . Se si specifica questa opzione, è necessario usare anche l'opzione /collectionName . Se si usa l'opzione /delete , il database per la raccolta specificata verrà arrestato e la raccolta verrà disconnessa definitivamente da Azure DevOps Server. Non sarà possibile ricollegare il database di raccolta a questa o a qualsiasi altra distribuzione.
NomeDellaCollezione	Specifica il nome della raccolta di progetti. Se il nome della raccolta contiene spazi, è necessario racchiudere il nome tra virgolette, ad esempio "Raccolta personale". Obbligatorio se si usa /detach o /delete . Se si usa questa opzione con /detach o /delete, specifica la raccolta che verrà scollegata o eliminata. Se si usa questa opzione con /attach, specifica un nuovo nome per la raccolta. Se si usa questa opzione con /attach e /clone, specifica il nome per la raccolta duplicata.
CollectionDB	Obbligatorio se si usa /attach . Questa opzione specifica il nome del server che esegue SQL Server e il nome del database di raccolta ospitato in tale server.
Nome del Server	Specifica il nome del server che ospita il database di configurazione per Azure DevOps Server e il nome dell'istanza se si vuole usare un'istanza diversa dall'istanza predefinita. Se si specifica un'istanza, è necessario usare il formato: `ServerName\InstanceName`.
Nome del database	Specifica il nome del database di configurazione. Per impostazione predefinita, il nome del database è TFS_ConfigurationDB.
clone	Se si specifica questa opzione, il database di raccolta originale verrà collegato come clone in SQL Server e questo database verrà collegato ad Azure DevOps Server. Questa opzione viene usata principalmente come parte della suddivisione di una raccolta di progetti.

Suggerimento

L'opzione /delete non eliminerà il database di raccolta da SQL Server. Dopo aver eliminato il database di raccolta da Azure DevOps Server, è possibile eliminare manualmente il database da SQL Server.

Prerequisiti

Per usare il comando collections , è necessario essere membri del gruppo di sicurezza Amministratori di Team Foundation, nonché del gruppo Administrators locale nel computer che esegue TfsConfig. È anche necessario essere un membro del ruolo di sicurezza sysadmin per tutte le istanze di SQL Server usate dai database di Azure DevOps Server. Se la distribuzione è integrata con SharePoint e si utilizza l'opzione /delete, è necessario essere anche un membro del gruppo Amministratori Farm per la farm di SharePoint da cui si intende eliminare la raccolta siti.

Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Osservazioni:

Per gestire le raccolte in modo interattivo o per creare una raccolta, è possibile usare il nodo Raccolte progetti nella console di amministrazione di Azure DevOps. Vedere Gestire le raccolte di progetti.

Esempi

L'esempio seguente illustra come rimuovere definitivamente la raccolta di Contoso Summer Intern Projects progetti da una distribuzione di Azure DevOps Server.

TfsConfig collection /delete /CollectionName:"Contoso Summer Intern Projects"

TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.
Deleting a project collection is an irreversible operation. A deleted collection cannot be reattached to the same or another Team Foundation Server. Are you sure you want to delete 'Contoso Summer Intern Projects'? (Yes/No)
Yes
Found Collection 'Contoso Summer Intern Projects' Deleting...
The delete of collection 'Contoso Summer Intern Projects' succeeded.

L'esempio seguente illustra come duplicare la Contoso Summer Interns Projects raccolta di progetti, denominarla Contoso Winter Interns Projectse collegare la raccolta duplicata alla distribuzione di Azure DevOps Server.

TfsConfig collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects"
    /CollectionName:"Contoso Winter Intern Projects" /clone

Indice di archiviazione delle colonne

Nota

Disponibilità dei comandi: richiede TFS 2015.2 e versioni successive.

Usare il comando columnStoreIndex per abilitare o disabilitare gli indici dell'archivio colonne per i database usati dalla distribuzione di Azure DevOps Server.

TfsConfig columnStoreIndex /enabled:<true|false>
	/sqlInstance:<serverName>
	/databaseName:<databaseName>

Opzione	Descrizione
Abilitato	Specifica se si sta abilitando o disabilitando l'indice dell'archivio colonne per l'istanza e il database SQL specificati.
sqlInstance	Specifica il nome del server che ospita il database per il quale viene abilitato o disabilitato l'indice dell'archivio colonne e il nome dell'istanza se viene utilizzata un'istanza diversa da quella predefinita. Se si specifica un'istanza, è necessario usare il formato: `ServerName\InstanceName`.
nomeDelDatabase	Specifica il nome del database per il quale l'indice dell'archivio colonne è abilitato o disabilitato.

Prerequisiti

Per usare il comando columnStoreIndex , è necessario essere un membro del ruolo sysadmin per l'istanza di SQL Server specificata.

Osservazioni:

In genere si usa il comando columnStoreIndex se si sposta un database da un'istanza di SQL che supporta l'indice dell'archivio colonne a uno che non lo ha fatto. In questo caso, è necessario disabilitare tutti gli indici dell'archivio colonne prima di poter spostare correttamente i database. Analogamente, se si stava spostando un database in un'istanza SQL che supporta l'indice dell'archivio colonne, è possibile riattivare l'indice dell'archivio colonne per risparmiare spazio e ottenere prestazioni migliori.

Esempio

Nell'esempio seguente viene illustrato come abilitare l'indice dell'archivio colonne per un database denominato TFS_DefaultCollection in un'istanza SQL in esecuzione in un server denominato ContosoMain nell'istanza TeamDatabasesdenominata .

TfsConfig columnStoreIndex /enabled:true /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection

ConfigureMail

Configurare il server che esegue Azure DevOps Server per l'uso di un server SMTP esistente per gli avvisi di posta elettronica.

TfsConfig configureMail /Enabled:<true|false> /FromEmailAddress:<emailAddress> /SmtpHost:<SMTPHostName>

Opzione	Descrizione
Indirizzo email del mittente	Specifica l'indirizzo da cui inviare notifiche tramite posta elettronica da Azure DevOps Server per un'archiviazione, un elemento di lavoro assegnato all'utente o altre notifiche. Questo indirizzo viene anche verificato per la validità e, a seconda della configurazione del server, potrebbe dover rappresentare un account di posta elettronica valido nel server di posta elettronica. Se l'indirizzo non esiste o non è valido, viene usato l'indirizzo di posta elettronica predefinito.
SmtpHost	Specifica il nome del server che ospita il server di posta elettronica.

Opzione

Descrizione

Indirizzo email del mittente

Specifica l'indirizzo da cui inviare notifiche tramite posta elettronica da Azure DevOps Server per un'archiviazione, un elemento di lavoro assegnato all'utente o altre notifiche. Questo indirizzo viene anche verificato per la validità e, a seconda della configurazione del server, potrebbe dover rappresentare un account di posta elettronica valido nel server di posta elettronica. Se l'indirizzo non esiste o non è valido, viene usato l'indirizzo di posta elettronica predefinito.

SmtpHost

Specifica il nome del server che ospita il server di posta elettronica.

Prerequisiti

Per usare il comando configureMail , è necessario essere membri del gruppo di sicurezza Amministratori di Team Foundation nel server a livello di applicazione Azure DevOps. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server

Osservazioni:

È anche possibile usare la console di amministrazione per configurare Azure DevOps Server per l'uso di un server SMTP.

Esempio

Nell'esempio seguente viene illustrata la sintassi utilizzata per configurare dall'indirizzo email a TFS@contoso.com e il server di posta SMTP come ContosoMailServer.

TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer

DBCompression (Compressione del Database)

Usare il comando dbCompression per abilitare o disabilitare la compressione delle pagine del database per i database usati dalla distribuzione di Azure DevOps Server.

TfsConfig dbCompression /pageCompression:[enable|disable]
	/sqlInstance:<serverName>
	/databaseName:<databaseName>
	[/rebuildNow [/offline]]

Opzione	Descrizione
pageCompression	Specifica se si sta abilitando o disabilitando la compressione di pagina per l'istanza e il database SQL specificati.
sqlInstance	Specifica il nome del server che ospita il database per il quale viene abilitata o disabilitata la compressione di pagina e il nome dell'istanza se viene utilizzata un'istanza diversa da quella predefinita. Se si specifica un'istanza, è necessario usare il formato seguente: `ServerName\InstanceName`
nomeDelDatabase	Specifica il nome del database per il quale la compressione di pagina è abilitata o disabilitata.
ricostruisciOra	Opzionale. Specifica se gli indici del database devono essere ricompilati (e compressi o decompressi in base alle esigenze). Se non usato, gli indici verranno ricompilati da un processo in background che viene eseguito settimanalmente.
offline	Opzionale. Usato solo in combinazione con /rebuildNow. Se /offline non è specificato, gli indici verranno ricompilati online. Se si specifica /offline , gli indici verranno ricompilati offline. Ciò bloccherà altre operazioni, ma potrebbe essere più veloce di una ricompilazione dell'indice online.

Prerequisiti

Per usare il comando dbCompression , è necessario essere un membro del ruolo sysadmin per l'istanza di SQL Server specificata.

Osservazioni:

In genere si usa il comando dbCompression se si sposta un database da un'istanza di SQL che supportava la compressione a quella che non lo era. In questo caso, è necessario disabilitare la compressione e decomprimere tutti gli indici prima di poter spostare correttamente i database. Analogamente, se si sposta di nuovo un database in un'istanza DI SQL che supportava la compressione, è possibile riabilitare la compressione per risparmiare spazio.

Questo comando cambia solo se Azure DevOps Server preferisce usare o meno la compressione delle pagine del database. I database devono comunque essere ospitati in un'istanza di SQL la cui edizione supporta la compressione. Per altre informazioni, vedere Funzionalità supportate dalle edizioni di SQL Server .

Esempio

Nell'esempio seguente viene illustrato come abilitare immediatamente la compressione di pagina, con indici ricompilati online, per un database denominato TFS_DefaultCollection in un'istanza SQL in esecuzione in un server denominato ContosoMain nell'istanza TeamDatabasesdenominata .

TfsConfig dbCompression /pageCompression:enable /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /rebuildNow

DeleteTestResults

Utilizzare il comando deleteTestResults per eliminare i vecchi risultati dei test archiviati dal negozio di raccolta. Questa operazione viene in genere eseguita per ridurre le dimensioni dell'archivio o per ridurre il tempo impiegato durante la migrazione dei risultati dei test a un nuovo schema.

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]

Opzione	Descrizione
etàInGiorni	I risultati dei test precedenti al numero di giorni specificato verranno eliminati o visualizzati in anteprima.
sqlInstance	Nome del server che ospita il database per cui i risultati del test vengono eliminati o visualizzati in anteprima e il nome dell'istanza se viene utilizzata un'istanza diversa da quella predefinita. Se si specifica un'istanza, è necessario usare il formato: `ServerName\InstanceName`.
nomeDelDatabase	Nome del database per cui i risultati dei test vengono eliminati o visualizzati in anteprima.
tipo	Opzionale. Tipo di risultati del test da eliminare. I valori validi sono automatizzati, manuali e tutti.
anteprima	Opzionale. Visualizzare il numero di risultati dei test che verrebbero eliminati in base all'età in giorni, ma non eliminare questi risultati.

Prerequisiti

Per usare il comando deleteTestResults , è necessario essere un membro del ruolo sysadmin per l'istanza di SQL Server specificata.

Osservazioni:

Usare il parametro /preview per visualizzare i risultati del test ordinati in base al nome e all'anno del progetto senza eliminare questi risultati.

Esempio

Nell'esempio seguente viene illustrato come eliminare i risultati dei test manuali precedenti a 60 giorni per un database denominato TFS_DefaultCollection in un'istanza SQL in esecuzione in un server denominato ContosoMain nell'istanza TeamDatabasesdenominata .

TfsConfig deleteTestResults /ageInDays:60 /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /type:manual

DeploymentPool

Il comando deploymentPool è progettato per eseguire la migrazione di tutti i gruppi di distribuzione da un pool di distribuzione a un altro.

TfsConfig deploymentpool /migrateDeploymentGroups /fromPool:<source pool name> /toPool:<destination pool name>

Opzione	Descrizione
fromPool	Nome del pool di origine.
toPool	Nome del pool di destinazione.

Identità

Il comando identità elenca o modifica l'identificatore di sicurezza (SID) di utenti e gruppi nella distribuzione di Azure DevOps Server. Potrebbe essere necessario modificare o aggiornare il SID per utenti e gruppi in uno degli scenari seguenti:

Modifica del dominio della distribuzione
Passaggio da un gruppo di lavoro a un dominio o da un dominio a un gruppo di lavoro
Migrazione di account tra domini in Active Directory

Nota

Non è necessario eseguire questo comando se si modificano domini all'interno della stessa foresta Active Directory. Azure DevOps Server gestirà automaticamente le modifiche SID per gli spostamenti all'interno della stessa foresta.

TfsConfig identities [/change /fromdomain:<domainName1> /todomain:<domainName2>
    [/account:<accountName> [/toaccount:<accountName>]] [/sqlInstance:<serverName> /databaseName:<databaseName>]

Opzione	Descrizione
cambiamento	Specifica che si desidera modificare le identità anziché elencarle.
fromdomain	Obbligatorio quando si usa /change. Specifica il dominio originale delle identità che si desidera modificare. Se si passa da un ambiente del gruppo di lavoro, specifica il nome del computer.
todomain	Obbligatorio quando si usa /change. Specifica il dominio a cui si desidera modificare le identità. Se si passa a un ambiente del gruppo di lavoro, specifica il nome del computer.
conto	Specifica il nome di un account per il quale si desidera elencare o modificare le identità.
toaccount	Specifica il nome di un account a cui si desidera modificare le identità.
SQLInstance	Specifica il nome del server che esegue SQL Server e il nome dell'istanza se si desidera utilizzare un'istanza diversa dall'istanza predefinita. Se si specifica un'istanza, è necessario usare il formato seguente: NomeServer\NomeIstanza
Nome del database	Specifica il nome del database di configurazione per Azure DevOps Server.

Prerequisiti

Per usare il comando identità , è necessario essere membri del gruppo di sicurezza Amministratori di Team Foundation e membro del ruolo sysadmin per tutte le istanze di SQL Server usate da Team Foundation Server. Per altre informazioni, vedere Impostare le autorizzazioni di amministratore per Azure DevOps Server.

Osservazioni:

Facoltativamente, è possibile specificare il database per modificare le identità prima di configurare un server a livello di applicazione per la distribuzione. Ad esempio, è possibile specificare il database per modificare l'account del servizio quando si clona una distribuzione di Azure DevOps Server.

Quando si modificano le identità, l'account o gli account di destinazione devono già esistere in Windows.

È necessario attendere la successiva sincronizzazione delle identità con Windows prima che le proprietà degli account modificati con questo comando vengano aggiornate. Questo requisito include modifiche dal gruppo all'utente, dall'utente al gruppo e dall'account di dominio all'account locale.

Esempi

Nell'esempio seguente viene illustrato come elencare i nomi di tutti gli utenti e i gruppi di Windows archiviati in Azure DevOps Server e per visualizzare se il SID per ogni utente o gruppo corrisponde al SID in Windows. Gli amministratori di dominio Contoso1 hanno creato gruppi di dominio come Contoso1\\Developers e Contoso1\\Testers per semplificare la gestione delle autorizzazioni in Azure DevOps Server, SQL Server Reporting Services e Prodotti SharePoint.

TfsConfig identities

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.

    Account Name Exists (see note 1) Matches (see note 2)
    --------------------------------------------------------------------
    CREATOR OWNER True True
    Contoso1\hholt True True
    BUILTIN\Administrators True True
    Contoso1\Developers True True
    Contoso1\Testers True True
    Contoso1\PMs True True
    Contoso1\jpeoples True True
    Contoso1\Domain Admins True True
    Contoso1\SVCACCT1 True True

    9 security identifiers (SIDs) were found stored in Team Foundation Server. Of these, 9 were found in Windows. 0 had differing SIDs.

L'esempio seguente illustra come modificare i SID per tutti gli account in Azure DevOps Server dal dominio Contoso1 ai SID per gli account con nomi corrispondenti nel ContosoPrime dominio. Solo i nomi di account che corrispondono avranno i SID aggiornati. Ad esempio, se l'account hholt esiste come Contoso1\hholt e ContosoPrime\hholt, il SID dell'account verrà modificato nel SID per ContosoPrime\hholt. Se l'account ContosoPrime\hholt non esiste, il SID non verrà aggiornato per Contoso1\hholt.

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

Nell'esempio seguente viene illustrato come modificare l'account per un singolo account utente, Contoso1\hholt, nell'account per un altro account utente, ContosoPrime\jpeoples.

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

Nell'esempio seguente viene illustrato come modificare il SID dell'account NT AUTHORITY\NETWORK SERVICE del servizio usato nella distribuzione di Azure DevOps Server quando si modifica il dominio della distribuzione da Contoso1 a ContosoPrime. Per modificare un account di sistema, ad esempio servizio di rete, è necessario seguire un processo in due fasi. Per prima cosa, modifichi l'account del servizio da NT AUTHORITY\NETWORK SERVICE a un account di dominio nel nuovo dominio TempSVC, e poi riporti l'account a servizio di rete sul server nel nuovo dominio. Il database di configurazione è ospitato nel server denominato ContosoMain nell'istanza TeamDatabases denominata in SQL Server.

TfsConfig identities /change /fromdomain:"NT AUTHORITY" /todomain:ContosoPrime /account:"NETWORK SERVICE"
  /toaccount:TempSVC /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

TfsConfig identities /change /fromdomain:ContosoPrime /todomain:"NT AUTHORITY" /account:TempSVC
	/toaccount:"NETWORK SERVICE"

Lavori

È possibile usare il comando jobs per creare un file di log che fornisce i dettagli dell'attività di processo più recente per una raccolta di progetti specifica o per ripetere un processo per una o tutte le raccolte di progetti.

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]

Opzione	Descrizione
riprova	Obbligatorio se /dumplog non viene usato. Specifica che l'attività più recente verrà riprovata per la raccolta di progetti specificata. Se si usa questa opzione, è necessario usare anche l'opzione /CollectionName o /CollectionID .
dumplog	Obbligatorio se /retry non viene usato. Specifica che l'attività più recente per la raccolta verrà inviata a un file di log. Se si usa questa opzione, è necessario usare anche l'opzione /CollectionName o /CollectionID .
NomeDellaCollezione	Obbligatorio se /CollectionID non viene utilizzato. Specifica il nome della raccolta per cui il lavoro più recente verrà riprovato (/riprovato) o registrato (/dumplog). Se si desidera specificare tutte le raccolte, è possibile usare un asterisco (*).
ID di Collezione	Obbligatorio se /CollectionName non viene utilizzato. Specifica il numero di identificazione della raccolta in cui l'incarico più recente verrà o ripetuto (/nuovo tentativo) o registrato (/dumplog).

Prerequisiti

Per usare il comando jobs , è necessario essere membri del gruppo di sicurezza Azure DevOps Administrators. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Osservazioni:

Per ripetere un processo in modo interattivo, è possibile aprire la console di amministrazione per Azure DevOps, selezionare la scheda Stato per la raccolta e quindi selezionare Riprova processo. Per altre informazioni, vedere Aprire la console di amministrazione di Azure DevOps.

Esempio

L'esempio seguente illustra come creare un file di log che elenca l'attività di processo più recente per la raccolta di Contoso Summer Intern Projects progetti in Azure DevOps Server.

TfsConfig jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"

OfflineDetach

Usare il comando offlineDetach per trasformare un database di raccolta offline in uno scollegato.

TfsConfig offlineDetach /configurationDB:<databaseName>
    /collectionDB:<databaseName>

Opzione	Descrizione
configurationDB	Specifica il nome del database di configurazione da utilizzare.
collectionDB	Specifica il nome del database di raccolta da scollegare.

Prerequisiti

Per usare il comando offlineDetach :

È necessario essere un membro del ruolo sysadmin per l'istanza di SQL Server specificata.
La versione dello strumento TFSConfig deve corrispondere alla versione del database di Azure DevOps Server.

Osservazioni:

Questo comando modifica lo schema del database di raccolta specificato e non deve mai essere eseguito su database usati da una distribuzione di Azure DevOps Server. Se i database sono in uso da una distribuzione di Azure DevOps Server, usare TfsConfig collection /detach invece .

Questo comando è utile quando è necessario ripristinare un singolo database di raccolta dal backup senza ripristinare altri database di raccolta che fanno parte della stessa distribuzione di Azure DevOps Server. In precedenza era necessario ripristinare un set completo e coerente di database (configurazione e tutte le raccolte) in un ambiente di gestione temporanea, configurare una distribuzione di Azure DevOps Server usando tali database e scollegare l'unica raccolta di interesse.

È invece possibile ripristinare copie coerenti del database di configurazione e del database di raccolta di interesse ed eseguire il comando offlineDetach . Il database di raccolta scollegato può quindi essere collegato a qualsiasi distribuzione di Azure DevOps Server in una versione appropriata.

Esempio

Nell'esempio seguente viene illustrato lo scollegamento di un database di raccolta denominato TFS_PrimaryCollection, usando un database di configurazione denominato TFS_Configuration, con entrambi in un'istanza SQL in esecuzione in un server denominato ContosoTemp nell'istanza Backupsdenominata .

TfsConfig offlineDetach /configurationDB:ContosoTemp\Backups;TFS_Configuration /collectionDB:ContosoTemp\Backups;TFS_PrimaryCollection

Intermediario

È possibile usare il comando proxy per aggiornare o modificare le impostazioni usate dal server proxy di Azure DevOps. Il server proxy di Azure DevOps fornisce il supporto per i team distribuiti per usare il controllo della versione gestendo una cache dei file di controllo della versione scaricati nel percorso del team distribuito. Configurando il server proxy di Azure DevOps, è possibile ridurre significativamente la larghezza di banda necessaria tra le connessioni a livello di area. Inoltre, non è necessario gestire il download e la memorizzazione nella cache dei file di versione; la gestione dei file è trasparente per lo sviluppatore che usa i file. Nel frattempo, eventuali scambi di metadati e caricamenti di file continuano a essere visualizzati in Azure DevOps Server. Se si usa Azure DevOps Services per ospitare il progetto di sviluppo nel cloud, è possibile usare il comando Proxy per gestire non solo la cache per i progetti nella raccolta ospitata, ma anche per gestire alcune delle impostazioni usate da tale servizio.

Per altre informazioni sull'installazione del server proxy di Azure DevOps e sulla configurazione iniziale del proxy,

Vedere Procedura: Installare il server proxy di Azure DevOps e configurare un sito remoto. Per altre informazioni sulla configurazione del proxy nei computer client, vedere Informazioni di riferimento sui comandi del controllo della versione di Azure DevOps.

TfsConfig proxy /add|delete|change [/Collection:<teamProjectCollectionURL> /account:<accountName>]
	/Server:<TeamFoundationServerURL> [/inputs:Key1=Value1; Key2=Value2;...] [/continue]

Opzione	Descrizione
Aggiungere	Aggiunge il server o la raccolta specificati all'elenco proxy nel file Proxy.config. È possibile eseguire /add più volte per includere più raccolte o server. Quando si usa /add con una raccolta ospitata in Azure DevOps Services, verranno richieste le credenziali in Azure DevOps Services.
cambiamento	Modifica le credenziali archiviate come account del servizio per Azure DevOps Services. L'opzione /change viene usata solo per Azure DevOps Services; non deve essere usato per le distribuzioni locali di Azure DevOps Server.
eliminare	Rimuove il server o la raccolta specificati dall'elenco proxy nel file Proxy.config.
conto	Specifica l'account usato come account del servizio per il proxy in Azure DevOps Services. Questa opzione viene usata solo per Azure DevOps Services insieme all'opzione /change. L'account del servizio predefinito usato per Azure DevOps Services è "Account Service".
continuare	Continua l'esecuzione del comando anche se il processo di verifica genera avvisi.
Raccolta	Specifica l'URL della raccolta di progetti ospitata in Azure DevOps Services, in `AccountName.DomainName/CollectionName` formato .
conto	Specifica il nome dell'account usato come account del servizio per Azure DevOps Services. Se il nome dell'account contiene spazi, il nome deve essere racchiuso tra virgolette (""). Tutti i caratteri speciali nei nomi degli account devono essere specificati in base alla sintassi della riga di comando.
conto	Specifica l'URL di una distribuzione di Azure DevOps Server, in `ServerURL:Port/tfs` formato .
PersonalAccessTokenFile	Facoltativamente, specifica il percorso di un file che contiene un token di accesso personale. Questo token verrà usato per l'autenticazione alla raccolta o all'account durante la registrazione di un proxy. Aggiunta in TFS 2018 Update 1
Ingressi	Opzionale. Specifica impostazioni e valori aggiuntivi da usare durante la configurazione del proxy. Ad esempio, i valori per `GvfsProjectName` e `GvfsRepositoryName` possono essere usati per configurare un repository Git da usare con Git Virtual File System (GVFS) (Aggiunto in TFS 2018 Update 1)

Prerequisiti

Per usare il comando proxy , è necessario essere membri del gruppo di sicurezza Azure DevOps Administrators e di un amministratore nel server proxy. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Osservazioni:

Usare il comando proxy per aggiornare la configurazione esistente di Azure DevOps Server Proxy. Non è possibile usare il comando proxy per l'installazione iniziale e la configurazione del proxy.

Esempi

L'esempio seguente illustra come aggiungere una distribuzione di Azure DevOps Server denominata FABRIKAM all'elenco di proxy.

TfsConfig proxy /add /Server:http://www.fabrikam.com:8080/tfs

L'esempio seguente illustra come aggiungere una raccolta di progetti ospitata in Azure DevOps Services all'elenco proxy usando un token di accesso personale per l'autenticazione. Questo token verrà usato solo per registrare il proxy con l'account Azure DevOps Services. L'account del servizio predefinito verrà comunque usato per eseguire il proxy. Questo parametro è stato aggiunto in TFS 2018 Update 1 per supportare la registrazione di un proxy con Azure DevOps Services senza richiedere una richiesta di accesso.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver

Nell'esempio seguente viene illustrato come aggiungere una raccolta di progetti all'elenco proxy. In questo esempio viene usato un token di accesso personale per eseguire l'autenticazione nella raccolta specificata con il /Collection parametro . Il token di accesso personale da usare viene salvato in un file in c:\PersonalAccessToken.txt.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/PersonalAccessTokenFile:c:\PersonalAccessToken.txt

L'esempio seguente illustra come modificare l'account del servizio usato dal proxy per la raccolta di progetti ospitata in Azure DevOps Services. La raccolta è denominata PhoneSaver, il nome dell'account usato per Azure DevOps Services è HelenaPetersen.fabrikam.come l'account del servizio usato dal proxy viene modificato in My Proxy Service Account. Poiché il nome dell'account contiene spazi, le virgolette vengono usate per racchiudere il nome.

TfsConfig proxy /change /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/account:"My Proxy Service Account"

L'esempio seguente illustra come aggiungere un repository Git da usare con GVFS.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver /inputs:GvfsProjectName=PhoneSaver;GvfsRepositoryName=AnotherRepository

RebuildWarehouse

È possibile usare il comando rebuildWarehouse per ricompilare i database di SQL Server Reporting Services e SQL Server Analysis Services usati da Azure DevOps Server.

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]

Opzione	Descrizione
analysisServices	Obbligatorio se /all non viene usato. Specifica che verrà ricompilato solo il database per Analysis Services. Se non esiste alcun database per Analysis Services, è necessario usare anche l'opzione /reportingDataSourcePassword .
tutto	Obbligatorio se /analysisServices non viene usato. Specifica che tutti i database di report e analisi usati da Azure DevOps Server verranno ricompilati.
reportingDataSourcePassword	Obbligatorio se il database TFS_Analysis non esiste. Specifica la password dell'account usato come account delle origini dati per SQL Server Reporting Services (TFSReports). Per ulteriori informazioni, vedere Service accounts and dependencies in Azure DevOps Server.

Prerequisiti

Per usare il comando rebuildWarehouse , è necessario essere membri dei gruppi seguenti:

Il gruppo di sicurezza Azure DevOps Administrators e il gruppo di sicurezza Administrators nel server o nei server che eseguono la console di amministrazione per Azure DevOps
Gruppo sysadmin nel server o nei server che eseguono l'istanza di SQL Server che ospita i database per Azure DevOps Server

Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Osservazioni:

È possibile usare questo comando durante lo spostamento o la suddivisione di una raccolta di progetti, il ripristino dei dati o la modifica della configurazione della distribuzione.

Per avviare la ricompilazione di questi database in modo interattivo, è possibile usare il nodo Reporting nella console di amministrazione per Azure DevOps. Per altre informazioni, vedere Aprire la console di amministrazione di Azure DevOps.

Esempio

L'esempio seguente illustra come ricompilare il database di Analysis Services per una distribuzione di Azure DevOps Server.

TfsConfig rebuildWarehouse /analysisServices

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.
    The Analysis Services database was successfully rebuilt.

RegisterDB

Usare registerDB per aggiornare il nome del server che ospita il database di configurazione in Azure DevOps Server. È possibile usare questo comando quando si ripristina il database di configurazione in un nuovo hardware o quando si modifica il dominio di una distribuzione.

TfsConfig registerDB /sqlInstance:<serverName> /databaseName:<databaseName>

Opzione	Descrizione
SQLInstance	Obbligatorio. Specifica il nome del server che esegue SQL Server e il nome dell'istanza se si desidera utilizzare un'istanza diversa dall'istanza predefinita. Se si specifica un'istanza, è necessario usare il formato: `ServerName\InstanceName`.
nomeDelDatabase	Obbligatorio. Specifica il nome del database di configurazione. Per impostazione predefinita, si tratta di Tfs_Configuration.

Prerequisiti

Per usare il comando registerDB , è necessario essere un membro del gruppo Azure DevOps Administrators nel server a livello di applicazione per Azure DevOps e un membro del gruppo sysadmin in SQL Server nel server livello dati per Azure DevOps. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Osservazioni:

Eseguire il backup dei database per Azure DevOps Server prima di usare questo comando.

Affinché il comando registerDB abbia esito positivo, è necessario eseguire i pool di applicazioni e i programmi seguenti:

Pool di applicazioni di Azure DevOps Server (pool di applicazioni)
ReportServer (pool di applicazioni)
SQL Server Reporting Services (programma)

Per il corretto funzionamento del comando, è necessario specificare il nome o l'indirizzo esatto del database di configurazione. Se è necessario modificare il server in cui è archiviato il database, è necessario assicurarsi che Azure DevOps Server punti alla nuova posizione.

Esempio

L'esempio seguente reindirizza Azure DevOps Server a un database di configurazione che si trova nel server ContosoMain nell'istanza TeamDatabasesdi SQL Server .

TfsConfig registerDB /SQLInstance:ContosoMain\TeamDatabases /databaseName:Tfs_Configuration

Rieseguire il mapping dei database

Il comando remapDBs reindirizza Azure DevOps Server ai relativi database quando vengono archiviati in più server e si sta ripristinando, spostando o modificando in altro modo la configurazione della distribuzione. Ad esempio, è necessario reindirizzare Azure DevOps Server a tutti i database per le raccolte di progetti se sono ospitati in un server o server separati dal database di configurazione. È inoltre necessario reindirizzare Azure DevOps Server al server o ai server che eseguono SQL Server Analysis Services o SQL Server Reporting Services se tali database sono ospitati in un server o un'istanza separata dal database di configurazione.

TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
	[/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
	[/preview] [/continue]

Opzione	Descrizione
Nome del database	Specifica il nome del server che ospita il database di cui si vuole eseguire il mapping per Azure DevOps Server, oltre al nome del database stesso.
SQLInstances	Specifica il nome del server che esegue SQL Server, oltre al nome dell'istanza se si desidera utilizzare un'istanza diversa dall'istanza predefinita. Se si specificano più server, è necessario usare una virgola per separare più coppie di nomi di server e istanze.
IstanzaDiAnalisi	Opzionale. Specifica il nome del server e dell'istanza che ospita SQL Server Analysis Services. Utilizzare questa opzione per specificare il server e l'istanza che ospita il database di Analysis Services.
AnalysisDatabaseName	Opzionale. Specifica il nome del database di Analysis Services che si vuole usare con Azure DevOps Server se nel server sono presenti più database specificati con l'opzione /AnalysisInstance .
anteprima	Opzionale. Visualizza le azioni che è necessario eseguire per aggiornare la configurazione.
continuare	Opzionale. Specifica che il comando RemapDB deve continuare anche se si verifica un errore durante il tentativo di individuare uno o più database. Se si usa l'opzione /continue , tutte le raccolte i cui database non vengono trovati nel server o nei server specificati verranno riconfigurati in modo da usare il server e l'istanza che ospita il database di configurazione.

Prerequisiti

Per usare il comando remapDBs , è necessario essere membri del gruppo di sicurezza Azure DevOps Administrators e membro del gruppo di sicurezza sysadmin per tutti i database di SQL Server usati da Azure DevOps Server. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Osservazioni:

Usare il comando remapDBs per riconfigurare Azure DevOps Server per usare server e istanze di SQL Server diversi dai server e dalle istanze nell'installazione originale.

Esempio

L'esempio seguente illustra come reindirizzare Azure DevOps Server al database TFS_Configurationdi configurazione. Questo database è ospitato su ContosoMain nell'istanza denominata TeamDatabases. I database della raccolta di progetti vengono archiviati sia su ContosoMain\TeamDatabases che nell'istanza predefinita in Contoso2.

TfsConfig remapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
	/SQLInstances:ContosoMain\TeamDatabases,Contoso2

RepairJobQueue

Usare il comando repairJobQueue per correggere i processi pianificati che hanno smesso di funzionare sugli host di distribuzione e raccolta.

TfsConfig repairJobQueue

Prerequisiti

Per usare il comando repairJobQueue , è necessario essere un membro del gruppo administrators locale nel computer che esegue TfsConfig. È anche necessario essere un membro del ruolo di sicurezza sysadmin per tutte le istanze di SQL Server usate dalla distribuzione di Azure DevOps Server.

Osservazioni:

In genere si usa il comando repairJobQueue se si nota che i processi pianificati non sono in esecuzione.
Il comando non accetta argomenti e richiede la configurazione della distribuzione di Azure DevOps Server.

Esempio

TfsConfig repairJobQueue

Impostazioni

È possibile usare il comando settings per automatizzare le modifiche apportate all'URL (Uniform Resource Locator) usato dall'interfaccia di notifica e per l'indirizzo del server per Azure DevOps Server. Per impostazione predefinita, l'URL dell'interfaccia di notifica e l'URL del server corrispondono in Azure DevOps Server, ma è possibile configurare URL separati. Ad esempio, è possibile usare un URL diverso per i messaggi di posta elettronica automatici generati da Azure DevOps Server. È necessario eseguire questo strumento dal livello applicazione per aggiornare tutti i server in modo che usino i nuovi URL.

Per modificare questi URL in modo interattivo o semplicemente visualizzare le impostazioni correnti, è possibile usare la console di amministrazione per Azure DevOps. Vedere Informazioni di riferimento rapido sulle attività amministrative.

TfsConfig settings [/publicURL:URL]

Opzione	Descrizione
URL pubblico	Specifica l'URL del server livello applicazione per Azure DevOps. Questo valore viene archiviato nel database di configurazione per Azure DevOps.

Prerequisiti

È necessario essere membri del gruppo di sicurezza Azure DevOps Administrators e del gruppo Administrators nel server a livello di applicazione. Per altre informazioni, vedere Impostare le autorizzazioni di amministratore per Azure DevOps Server.

Osservazioni:

Il comando settings modifica le informazioni di connessione per la comunicazione da server a server in una distribuzione di Azure DevOps Server. L'URL specificato in /publicURL deve essere disponibile per tutti i server all'interno della distribuzione.

Esempio

Nell'esempio seguente il valore di NotificationURL viene modificato in http://contoso.example.com/tfs e il valore di ServerURL in http://contoso.example.com:8080/tfs.

TfsConfig settings /publicURL:http://contoso.example.com:8080/tfs

Configurazione

Usare il comando di installazione per disinstallare le funzionalità attualmente configurate nel computer in cui si esegue il comando.

TfsConfig setup /uninstall:<feature[,feature,...]>

Opzione

Descrizione

/uninstall

Specifica una o più funzionalità da disinstallare dal computer in cui si esegue il comando. Le opzioni includono: All, ApplicationTier, Search e VersionControlProxy.

Prerequisiti

Per usare il comando di installazione , è necessario essere membri del gruppo di sicurezza Azure DevOps Administrators.

Esempi

L'esempio seguente disinstalla tutte le funzionalità di Azure DevOps Server dal computer corrente.

TfsConfig setup /uninstall:All

Nell'esempio seguente vengono disinstallati il livello applicativo e le funzionalità di build dal computer corrente.

TfsConfig setup /uninstall:ApplicationTier

TCM

Quando si esegue l'aggiornamento alla versione più recente di Azure DevOps Server, il sistema tenta automaticamente di aggiornare i componenti di Gestione test, inclusi i piani di test e i gruppi.

Se la migrazione automatica non riesce, usare il comando TCM per aggiornare manualmente i piani di test e i gruppi di test ai rispettivi tipi di elemento di lavoro (WIT).

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

Opzione

Descrizione

/upgradeTestPlans

Obbligatorio a meno che non venga usato /upgradeStatus .

Converte i piani di test e le suite di test esistenti in modo che puntino ai piani di test e alle suite di test basati su elementi di lavoro. Aggiorna anche i dati di gestione dei test esistenti e i collegamenti tra altri artefatti di test esistenti, ad esempio punti di test, esecuzioni di test e risultati dei test.

/upgradeStatus

Obbligatorio a meno che non venga usato /upgradeTestPlans .

Segnala lo stato della migrazione dei dati di test per il progetto specificato. Indicherà anche se il progetto specificato ha piani di test.

/CollectionName:CollectionName

Obbligatorio. Specifica la raccolta di progetti che contiene il progetto per il quale si desidera eseguire la migrazione dei dati di test o controllare lo stato della migrazione.

Se sono presenti spazi nel nome della raccolta di progetti, racchiudere il nome tra virgolette, ad esempio "Fabrikam Fiber Collection".

/TeamProjectName:TeamProjectName

Obbligatorio. Specifica il progetto per il quale si vuole eseguire la migrazione dei dati di test o controllare lo stato della migrazione. Questo progetto deve essere definito nella raccolta specificata usando il parametro /collectionName .

Se sono presenti spazi nel nome del progetto, racchiudere il nome tra virgolette, ad esempio "My Project".

Prerequisiti

È necessario essere membri del gruppo di sicurezza Amministratori di Team Foundation e un amministratore sul server del livello applicativo.

Vedere Impostare le autorizzazioni di amministratore per Azure DevOps Server.

Osservazioni:

Per usare questo comando, è necessario aggiornare il server a livello di applicazione alla versione più recente di Azure DevOps Server 2019.

Prima di poter usare il comando TCM, è necessario importare la definizione dell'elemento di lavoro del piano di test e la categoria del piano di test nel progetto.

Per altre informazioni sulla migrazione e su quando usare questo comando, vedere Aggiornamenti manuali per supportare la gestione dei test.

Il comando TCM viene applicato ai singoli progetti. Se è necessario aggiornare i piani di test in più progetti, sarà necessario eseguirlo singolarmente in ogni progetto.

È necessario eseguire il comando TCM dalla directory degli strumenti per Azure DevOps Server. Per impostazione predefinita, tale percorso è: drive:\%programfiles%\TFS 12.0\Tools.

Il comando TCM viene usato solo nel caso in cui la migrazione automatica dei dati di test esistenti non riesca.

Per altre informazioni sulla migrazione e su quando usare questo comando, aggiornamenti manuali per supportare la gestione dei test. Se non è possibile accedere ai piani di test o ai gruppi di test definiti prima dell'aggiornamento del server, eseguire TFSConfig TCM upgradeStatus per determinare lo stato della migrazione.

Eseguire il comando TCM per un singolo progetto. Se è necessario aggiornare più progetti, dovrai eseguirlo per ogni progetto a sua volta.

Esempi

Nell'esempio seguente viene illustrato come controllare lo stato dell'aggiornamento del piano di test nel progetto Fabrikam Fiber ospitato nella raccolta di progetti predefinita (DefaultCollection):

tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"

Installazione non supervisionata

Disponibilità dei comandi: Azure DevOps Server 2019

Il comando unattend è progettato per gli utenti che hanno familiarità con Azure DevOps Server e con il processo di configurazione, e che devono installare Azure DevOps Server su macchine diverse.

Ad esempio, se si usa Azure DevOps Build, è possibile usare il comando unattend per installare più server di compilazione usando lo stesso file di configurazione.

Usare l'opzione /create per creare un file unattended. Questo file definisce tutti i parametri di configurazione per un'installazione di Azure DevOps Server. Successivamente, usare l'opzione /configure per eseguire effettivamente la configurazione.

Questo processo consente di configurare Azure DevOps Server dall'inizio alla fine senza dover fornire input durante il processo di installazione. Nel caso di più installazioni, ciò consente anche di garantire che gli stessi parametri di configurazione vengano usati in più server.

TfsConfig unattend /create|configure /type:InstallType /unattendfile:ConfigurationFileName 
    [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]

Opzione	Descrizione
creare	Crea il file di installazione automatica con il nome e i parametri specificati.
configurare	Configura Azure DevOps Server utilizzando il file di installazione automatica e i parametri che specifichi. È necessario usare /type o /unattendfile con questa opzione.
tipo	Specifica il tipo di configurazione da utilizzare. Quando si usa /configure, sono necessari /type o /unattendfile, ma non è possibile usare entrambi.
unattendfile	Specifica il file di installazione automatica da creare o usare, a seconda che il parametro iniziale sia /create o /configure. Quando si usa /configure, è necessario specificare /unattendfile o /type.
Ingressi	Opzionale. Se usi /create, specifica le impostazioni e i valori da usare durante la creazione del file Unattend. Se si utilizza /configure, specifica impostazioni e valori aggiuntivi da usare in combinazione con il file di installazione automatica. In alternativa all'uso di /inputs, è possibile modificare manualmente il file di installazione automatica in qualsiasi editor di testo normale. Questa operazione è necessaria per determinati tipi di input, ad esempio ServiceAccountPassword o PersonalAccessToken, perché tali valori segreti non possono essere impostati usando il parametro /inputs.
verificare	Opzionale. Specifica un'esecuzione di configurazione che completa solo i controlli di verifica in base al file di risposta automatica, agli input e al tipo di configurazione. Si tratta di un'alternativa all'esecuzione di una configurazione completa.
continuare	Opzionale. Specifica che /create o /configure dovrebbero continuare indipendentemente dagli avvisi dei controlli di verifica.

Tipo di installazione	Descrizione
NewServerBasic	Configura i servizi di sviluppo essenziali per Azure DevOps Server. Sono inclusi il controllo del codice sorgente, gli elementi di lavoro, la compilazione e, facoltativamente, la ricerca.
NewServerAdvanced	Configura i servizi di sviluppo essenziali e consente la configurazione facoltativa dell'integrazione con Reporting Services.
Aggiornamento	Aggiorna Azure DevOps Server alla versione corrente da una versione precedente supportata.
PreProductionUpgrade	Testare l'aggiornamento in una distribuzione esistente di Azure DevOps Server in un ambiente di pre-produzione. Questa operazione viene in genere eseguita usando i database ripristinati dai backup di produzione. Questo scenario include passaggi aggiuntivi per garantire che la nuova distribuzione non interferisca con la distribuzione di produzione.
ApplicationTierOnlyBasic	Configurare un nuovo livello applicazione usando le impostazioni esistenti dal database di configurazione fornito. Questa opzione consente di ottenere un nuovo livello applicazione in esecuzione rapidamente usando le impostazioni esistenti. Se si vuole modificare le impostazioni esistenti, usare invece il tipo Advanced ApplicationTierOnlyAdvanced.
LivelloApplicazioneSoloAvanzato	Configurare un nuovo livello applicazione con controllo completo su tutte le impostazioni. Le impostazioni di default saranno quelle esistenti nel database di configurazione fornito. Se si desidera mantenere tutte le impostazioni esistenti, usare invece il tipo ApplicationTierOnlyBasic.
Clone	Configurare una nuova distribuzione di Azure DevOps Server che è un clone di una distribuzione esistente. Questa operazione viene in genere eseguita, usando i database ripristinati dai backup di produzione, per creare un ambiente in cui è possibile testare le modifiche di configurazione, le estensioni e altre modifiche. Questo scenario include passaggi aggiuntivi per garantire che la nuova distribuzione non interferisca con la distribuzione di produzione.
Intermediario	Configura un servizio proxy di controllo della versione.

Prerequisiti

È necessario essere membri del gruppo Administrators nel computer in cui si installa il software.
A seconda del tipo di installazione, è anche possibile richiedere autorizzazioni di amministratore aggiuntive.

Ad esempio, se si usa il comando unattend per installare Azure DevOps Server, è necessario essere membri del gruppo sysadmin nell'istanza di SQL Server che supporterà Azure DevOps Server. Per altre informazioni, vedere la sezione domande e risposte di Aggiungere amministratori a livello di server ad Azure DevOps Server.

Osservazioni:

Prima di poter usare il comando unattend per configurare Azure DevOps Server, è necessario creare gli account del servizio che verranno usati come parte della distribuzione. È inoltre necessario installare qualsiasi software prerequisito per il tipo di installazione scelto. Questo include Azure DevOps Server stesso. È necessario installare Azure DevOps Server, ma non è necessario configurarlo perché il comando unattend se ne occuperà.

Il comando unattend configura i componenti di Azure DevOps Server. Non esegue l'installazione iniziale del software. Configura il software in base alle specifiche una volta che i dati sono presenti sul computer.

Esempi

L'esempio seguente illustra come creare un file unattend per un'installazione di base di Azure DevOps Server.

TfsConfig unattend /create /type:basic /unattendfile:configTFSBasic.ini

In questo esempio, il file di risposta viene creato nella stessa directory del comando. Un file di log viene creato come parte del comando e il percorso del file viene restituito nel comando come parte dell'esecuzione del comando.

L'esempio seguente illustra come specificare un repository Git da usare con GVFS durante la configurazione.

TfsConfig unattend /configure /type:proxy /inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection;GvfsProjectName=Fabrikam-Fiber-Git;GvfsRepositoryName=TestGit

L'esempio seguente illustra come creare un file senza supervisione per la configurazione di un proxy server di Azure DevOps.

Importante

In questo esempio, se gli amministratori vogliono usare un token di accesso personale per l'autenticazione, dovranno modificare manualmente il file per specificare il valore del token di accesso personale. A tale scopo, è possibile aggiungere una riga per il token di accesso personale nel file di installazione automatica creato, ad esempio : PersonalAccessToken=PersonalAccessTokenValue.

TfsConfig unattend /create /type:proxy "/inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection" /unattendFile:c:\unattend.txt

L'esempio seguente illustra come creare un file di installazione automatica per la configurazione della build di Azure DevOps Server in un server usando FabrikamFiber\BuildSVC come account del servizio di compilazione e quindi configurare la compilazione di Azure DevOps Server usando tale file di installazione automatica.

Importante

In questo esempio, dopo aver creato il file di installazione automatica, l'amministratore modifica manualmente il file per specificare la password per l'account del servizio di build. L'aggiunta della password come input tramite ServiceAccountPassword=PasswordPlaceholder; non aggiunge le informazioni sulla password al file.

TfsConfig unattend /create /type:build /unattendfile:configTFSBuild.ini
    /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

Il primo comando restituisce quanto segue:

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203133.log

Il secondo comando restituisce le informazioni seguenti, incluso il nome del server in cui è stata configurata FabrikamFiberTFS la build di Azure DevOps e la raccolta di progetti associata al controller DefaultCollection:

    Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
    Copyright (c) Microsoft Corporation. All rights reserved.

    Command: unattend

    ---------------------------------------------
            Inputs:
    ---------------------------------------------

    Feedback
            Send Feedback: True

    Build Resources
            Configuration Type: create
            Agent Count: 1
            New Controller Name: FabrikamFiberTFS - Controller
            Clean Up Resources: False

    Project Collection
            Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

    Windows Service
            Service Account: FabrikamFiber\BuildSVC
            Service Password: ********

    Advanced Settings *
            Port: 9191

    ---------------------------------------------
            Running Readiness Checks
    ---------------------------------------------

    [1/2] System Verifications
    [2/2] Build Service Verifications

    ---------------------------------------------
            Configuring
    ---------------------------------------------

            root
    [1/4] Install Team Foundation Build Service
            Installing Windows services ...
            Adding service account to groups ...
            Setting ACL on a windows service
    [2/4] Enable Event Logging
            Adding event log sources ...
            Token replace a config file
            RegisterBuildEtwProvider
            Configuring ETW event sources ...
    [3/4] Register with Team Foundation Server
            Registering the build service
    [4/4] Start Team Foundation Build Service
            StartBuildHost
            Starting Windows services ...
            Marking feature configured status
    [Info] [Register with Team Foundation Server] Firewall exception added for port
    9191

    TeamBuild completed successfully.
    Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

ZipLogs

Il comando ziplogs è progettato per raccogliere i log e eliminare un file ZIP in ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

Last updated on 2025-12-20

Condividi tramite

Usare TFSConfig per gestire Azure DevOps in locale

Posizione degli strumenti da riga di comando

Prerequisiti

Elenca i comandi e ottieni aiuto

Gli account

Prerequisiti

Osservazioni:

Esempi

AggiungiRapportiProgetto

Prerequisiti

Osservazioni:

Esempio

Autenticazione

Prerequisiti

Osservazioni:

Esempio

Certificati

Prerequisiti

Osservazioni:

Esempi

ChangeServerID

Prerequisiti

Osservazioni:

Esempio

Indice di Codice

Prerequisiti

Esempi

Raccolta

Prerequisiti

Osservazioni:

Esempi

Indice di archiviazione delle colonne

Prerequisiti

Osservazioni:

Esempio

ConfigureMail

Prerequisiti

Osservazioni:

Esempio

DBCompression (Compressione del Database)

Prerequisiti

Osservazioni:

Esempio

DeleteTestResults

Prerequisiti

Osservazioni:

Esempio

DeploymentPool

Identità

Prerequisiti

Osservazioni:

Esempi

Lavori

Prerequisiti

Osservazioni:

Esempio

OfflineDetach

Prerequisiti

Osservazioni:

Esempio

Intermediario

Prerequisiti

Osservazioni:

Esempi

RebuildWarehouse

Prerequisiti

Osservazioni:

Esempio

RegisterDB

Prerequisiti

Osservazioni:

Esempio

Rieseguire il mapping dei database

Prerequisiti

Osservazioni:

Esempio

RepairJobQueue

Prerequisiti

Osservazioni: