Usare TFSConfig per gestire Azure DevOps locale

Articolo
03/28/2024

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

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

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

Posizione dello strumento da riga di comando

Gli strumenti della riga di comando di Azure DevOps vengono installati nella directory /Tools di un server a livello di 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à disporre delle autorizzazioni amministrative per questi stessi server e servizi. I requisiti per i comandi specifici verranno chiamati 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 sul prompt dei comandi e quindi scegliere Esegui come amministratore. Per altre informazioni, vedere: Controllo 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.

Elencare i comandi e ottenere la Guida

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

TFSConfig help

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

TFSConfig help accounts

Account

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

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

È anche possibile usare questo comando per modificare la proprietà dei database 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
UpdatePassword	Modifica la password di un account usato come account del servizio. Modifica l'account esistente e tutti gli accountType eseguiti come account specificato.
Modifica	Modifica l'account usato come account del servizio. Aggiunge il nuovo account alle risorse e ai gruppi necessari, concede le autorizzazioni necessarie, quindi imposta il servizio per usarlo. Questa operazione non rimuove l'account precedente dalle risorse. Se non si usa l'opzione accountType , verrà modificato l'account del servizio per il livello applicazione.
Add	Aggiunge solo il nuovo account alle risorse necessarie. Utile per gli scenari di bilanciamento del carico di rete. Usare il flag di continuazione se alcune raccolte non sono raggiungibile. L'aggiunta può essere eseguita di nuovo in un secondo momento per aggiornare le raccolte perse. Aggiunge un account ai gruppi necessari per usare l'account come account del servizio.
Set	Imposta solo il servizio per usare un account già aggiunto alle risorse. Utile per gli scenari di bilanciamento del carico di rete.
Elimina	Rimuove l'account da tutte le risorse. Le precauzioni devono essere usate 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 al ripristino del server. Questa opzione esegue l'iterazione di tutti i database e imposta l'account di accesso dbo al proprietario corrente.

AccountType	Descrizione
AdminConsole	Gli utenti della console di amministrazione sono utenti che hanno concesso le autorizzazioni minime in varie risorse per l'uso della console.
ApplicationTier	Modifica l'account del servizio nell'appPool per i servizi Web principali. (TFSService)
Proxy	Modifica l'account del servizio nell'appPool per i servizi Web proxy. (TFSProxy)
ReportingDataSource	Modifica l'account usato dai report per accedere ai dati di report. (TFSReports)

Il valore predefinito è ApplicationTier.

SqlInstance e databaseName sono appropriati solo per l'uso quando si aggiunge 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 continua viene usata durante l'aggiunta o la modifica di un account. Per queste operazioni, l'account viene modificato in ogni database di raccolta. Se continua viene fornito, continuerà se una raccolta non è raggiungibile. Può essere eseguito di nuovo quando sono raggiungibili.

Nota

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

Parametro	Descrizione
Account	Specifica il nome dell'account da aggiungere, modificare o eliminare da un tipo di account a cui si fa riferimento, ad esempio /AccountType:ApplicationTier.
Password	Specifica la password dell'account del servizio. Questo parametro è facoltativo se si usa un account di sistema o un account privo di 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 vuole usare un'istanza diversa dall'istanza predefinita. È necessario specificare il nome e l'istanza nel formato seguente: ServerName\InstanceName.
databaseName	Usato solo con /ResetOwner. Specifica il nome del database la cui proprietà si vuole modificare. Tramite questo comando, si reimposta la proprietà del database specificato sull'account in cui si esegue il comando.
continue	Aggiorna eventuali gruppi non disponibili quando si esegue il comando. Questa opzione viene in genere usata in scenari NLB.

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.

Commenti

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 disporre dell'account sensibile e non può essere delegata per il server a livello di applicazione. Per altre informazioni, vedere questa pagina nel sito Web Microsoft: Abilitazione dell'autenticazione delegata.

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

Esempio

Modificare l'account del servizio delle origini dati per Reporting Services impostando un nuovo account nel dominio Contoso, Contoso\NewAccounte 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"

Modificare la proprietà del TFS_Warehouse database nel ContosoMain SQL Server nell'istanza TeamDatabases denominata impostandola sull'account utente in cui si esegue 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

AddProjectReports

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
collection	Obbligatorio. URL della raccolta di progetti team.
Teamproject	Obbligatorio. Specifica il nome del progetto team.
template	Obbligatorio. Specifica il nome del modello di processo. Le opzioni disponibili sono Agile, CMMI e Scrum.
force	facoltativo. Specifica che i report devono essere sovrascritti se già esistenti.

Prerequisiti

Per usare il comando addProjectReports , è necessario disporre delle autorizzazioni per eseguire TFSConfig e per caricare i report in Reporting Service.

Commenti

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 i report predefiniti perché sono stati aggiornati 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 Azure DevOps Server 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

Authentication

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

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 da modificare. Il livello applicazione è l'impostazione predefinita.

Prerequisiti

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

Commenti

Il comando Authentication viene usato da un amministratore che vuole modificare il protocollo di autenticazione di rete per uno o più siti Web in cui si basa Azure DevOps Server. L'amministratore esegue il comando dal livello applicazione per aggiornare i siti Web che richiedono una modifica del 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

L'esempio seguente mostra 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, ssl (Secure Sockets Layer) e certificati.

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

Opzione	Descrizione
computer	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.
autoSelect	Specifica che un certificato verrà selezionato automaticamente dall'elenco di 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.
identificazioni personali	Specifica che verrà utilizzato il certificato corrispondente all'identificazione personale 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.

Commenti

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

Esempio

Nell'esempio seguente viene illustrato come specificare il certificato del computer locale con l'identificazione personale aa bb cc dd ee senza richiedere 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 utenti 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 rischiare di interrompere 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 la modifica, ad eccezione del ripristino di 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 di , è necessario usare il formato : `ServerName\InstanceName`.
databaseName	Obbligatorio. Specifica il nome del database di configurazione per Azure DevOps Server. Per impostazione predefinita, il nome di questo database è TFS_ConfigurationDB.
projectCollectionsOnly	Specifica che verranno modificati solo i GUID per le raccolte.
configDBOnly	Specifica che verrà modificato solo il GUID per il database di configurazione.
collectionName	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 Amministratori di Azure DevOps 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.

Commenti

Usare il comando changeServerID per creare un duplicato discreto di una distribuzione di Azure DevOps Server a scopo 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

Nell'esempio seguente viene illustrato 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

CodeIndex

Usare il comando codeIndex per gestire l'indicizzazione del codice in Azure DevOps Server. Ad esempio, è possibile che si desideri reimpostare l'indice per correggere le informazioni di CodeLens o disabilitare l'indicizzazione per esaminare eventuali 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
indexingStatus	Mostrare lo stato e la configurazione del servizio di indicizzazione del codice.
setIndexing	on: avvia l'indicizzazione di tutti gli insiemi di modifiche. off: arresta l'indicizzazione di tutti gli insiemi di modifiche. keepupOnly: interrompe l'indicizzazione degli insiemi di modifiche creati in precedenza e avvia l'indicizzazione solo dei nuovi insiemi di modifiche.
ignoreList	Specifica l'elenco di file di codice e i rispettivi percorsi da non indicizzare. add: aggiunge il file da non indicizzare all'elenco di file ignorati. remove: rimuove il file da indicizzare dall'elenco di file ignorati. removeAll: cancella l'elenco dei file ignorati e avvia l'indicizzazione di tutti i file. view: visualizza tutti i file non sottoposti a indicizzazione. ServerPath: specifica il percorso di un file di codice. È possibile usare il carattere jolly (*) all'inizio, alla fine, oppure a entrambe le estremità del percorso server.
listLargeFiles	Mostra il numero specificato di file che supera la dimensione specificata in KB. È quindi possibile usare l'opzione /ignoreList per escludere questi file dall'indicizzazione. A questo scopo, è necessario Team Foundation Server 2013 con l'aggiornamento 3.
reindexAll	Cancellare i dati indicizzati in precedenza e riavviare l'indicizzazione.
destroyCodeIndex	Eliminare l'indice del codice e rimuovere tutti i dati indicizzati. Non è richiesta conferma se si usa l'opzione /noPrompt.
temporaryDataSizeLimit	Controllare la quantità di dati temporanei creati da CodeLens durante l'elaborazione degli insiemi di modifiche. Il limite predefinito è 6 GB (2 GB in Update 5). view: mostra il limite di dimensioni attuale. SizeInGBs: modificare il limite di dimensioni. disable: rimuove il limite di dimensioni. Questo limite viene verificato prima dell'elaborazione di un nuovo insieme di modifiche con CodeLens. Se i dati temporanei superano questo limite, CodeLens sospende l'elaborazione degli insiemi di modifiche precedenti, non di quelli nuovi. CodeLens riavvia l'elaborazione dopo che i dati sono stati puliti e sono tornati sotto il limite. La pulizia viene eseguita automaticamente una volta al giorno. Questo implica che i dati temporanei potrebbero superare questo limite prima dell'esecuzione del processo di pulizia. A questo scopo, è necessario Team Foundation Server 2013 con l'aggiornamento 4.
indexHistoryPeriod	Controllare la lunghezza dell'intervallo di indicizzazione della cronologia delle modifiche. Ciò incide sulla quantità di cronologia che CodeLens mostra all'utente. Il limite predefinito è di 12 mesi. Questo significa che CodeLens mostra la cronologia delle modifiche solo degli ultimi 12 mesi. view: mostra il numero di mesi corrente. all: indicizza 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.
collectionName	Specifica il nome dell'insieme di progetti sulla quale eseguire il comando CodeIndex. Obbligatoria se non si usa /CollectionId.
collectionId	Specifica il numero di identificazione dell'insieme di progetti sulla quale eseguire il comando CodeIndex. Obbligatorio se non si usa /CollectionName

Prerequisiti

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

Esempio

Per vedere la configurazione e lo stato di indicizzazione del codice:

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

Per avviare l'indicizzazione di tutti gli insiemi di modifiche:

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

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

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

Per trovare fino a 50 file con 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 sottoposti a indicizzazione:

TfsConfig codeIndex /ignoreList:view

Per cancellare i dati precedentemente indicizzati e riavviare l'indicizzazione:

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

Per salvare tutta la cronologia dell'insieme di modifiche:

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

Per rimuovere il limite di dimensioni nei dati temporanei di CodeLens e continuare l'indicizzazione indipendentemente dalle dimensioni dei dati temporanei:

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

Per eliminare l'indice di 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 a volte viene chiamato 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
attach	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.
create	Crea una raccolta.
scollegamento	Obbligatorio se non viene usato né /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.
eliminazione	Obbligatorio se non viene usato né /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à rimossa definitivamente dalla Azure DevOps Server. Non sarà possibile riassociare il database della raccolta a questa o a una qualsiasi altra distribuzione.
CollectionName	Specifica il nome della raccolta di progetti. Se il nome della raccolta contiene degli spazi, è necessario racchiuderlo tra virgolette (ad esempio, "Raccolta personale"). Obbligatorio se viene usato /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 viene usato /attach . Questa opzione specifica il nome del server che esegue SQL Server e il nome del database di raccolta ospitato in tale server.
ServerName	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`.
DatabaseName	Specifica il nome del database di configurazione. Per impostazione predefinita, il nome di questo 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 a 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 della 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 raccolte , è necessario essere un membro del gruppo di sicurezza Amministratori di Team Foundation e 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 Azure DevOps Server. Se la distribuzione è integrata con SharePoint e si usa l'opzione /delete , è necessario essere anche membro del gruppo Amministratori farm per la farm di SharePoint da cui si sta eliminando la raccolta siti.

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

Commenti

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

Esempio

Nell'esempio seguente viene illustrato come rimuovere definitivamente la Contoso Summer Intern Projects raccolta di 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.

Nell'esempio seguente viene illustrato come duplicare l'insieme Contoso Summer Interns Projects di progetti, denominarlo 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

ColumnStoreIndex

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
Enabled	Specifica se si abilita o disabilita 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 l'indice dell'archivio colonne è abilitato o disabilitato e il nome dell'istanza se viene usata un'istanza diversa dall'impostazione predefinita. Se si specifica un'istanza, è necessario usare il formato : `ServerName\InstanceName`.
databaseName	Specifica il nome del database per il quale l'indice dell'archivio colonne è abilitato o disabilitato.

Prerequisiti

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

Commenti

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

Esempio

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

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

ConfigureMail

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

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

Opzione	Descrizione
FromEmailAddress	Specifica l'indirizzo da cui inviare notifiche tramite posta elettronica da Azure DevOps Server per un controllo, un elemento di lavoro assegnato all'utente o altre notifiche. Questo indirizzo viene controllato anche 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

FromEmailAddress

Specifica l'indirizzo da cui inviare notifiche tramite posta elettronica da Azure DevOps Server per un controllo, un elemento di lavoro assegnato all'utente o altre notifiche. Questo indirizzo viene controllato anche 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 un membro del gruppo di sicurezza Team Foundation Administrators nel server a livello di applicazione Azure DevOps. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server

Commenti

È anche possibile utilizzare 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 l'oggetto dall'indirizzo di posta elettronica al TFS@contoso.com server di posta SMTP come ContosoMailServer:

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

DBCompression

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 delle pagine per l'istanza e il database SQL specificati.
sqlInstance	Specifica il nome del server che ospita il database per il quale la compressione di pagina è abilitata o disabilitata e il nome dell'istanza se viene utilizzata un'istanza diversa da quella predefinita. Se si specifica un'istanza di , è necessario usare il formato : `ServerName\InstanceName`
databaseName	Specifica il nome del database per cui è in corso l'abilitazione o la disabilitazione della compressione di pagina.
rebuildNow	facoltativo. Specifica se gli indici di database devono essere ricompilati (e compressi o decompressi in base alle esigenze). Se non viene usato, gli indici verranno ricompilati da un processo in background che viene eseguito settimanalmente.
Offline	facoltativo. 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 membro del ruolo sysadmin per l'istanza di SQL Server specificata.

Commenti

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

Questo comando modifica 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 gli indici ricompilati online, per un database denominato TFS_DefaultCollection in un'istanza DI SQL in esecuzione in un server denominato ContosoMain nell'istanza denominata TeamDatabases.

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

DeleteTestResults

Usare il comando deleteTestResults per eliminare i risultati dei test archiviati precedenti dall'archivio raccolte. 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
ageInDays	I risultati dei test precedenti al numero specificato di giorni verranno eliminati o visualizzati in anteprima.
sqlInstance	Nome del server che ospita il database per il quale 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 di , è necessario usare il formato : `ServerName\InstanceName`.
databaseName	Nome del database per il quale i risultati dei test vengono eliminati o visualizzati in anteprima.
tipo	facoltativo. Tipo di risultati del test da eliminare. I valori validi sono automatizzati, manuali e tutti.
preview	facoltativo. 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 membro del ruolo sysadmin per l'istanza di SQL Server specificata.

Commenti

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 DI SQL in esecuzione in un server denominato ContosoMain nell'istanza denominata TeamDatabases.

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 di 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 di 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
change (modifica)	Specifica che si desidera modificare le identità anziché elencarle.
fromdomain	Obbligatorio quando si usa /change. Specifica il dominio originale delle identità da modificare. Se si sta eseguendo la modifica da un ambiente di gruppi di lavoro, specifica il nome del computer.
todomain	Obbligatorio quando si usa /change. Specifica il dominio in cui si desidera modificare le identità. Se si sta eseguendo la modifica in un ambiente di gruppi di lavoro, specifica il nome del computer.
account	Specifica il nome di un account per cui si desidera elencare o modificare le identità.
toaccount	Specifica il nome di un account in 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
DatabaseName	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.

Commenti

È possibile specificare facoltativamente il database per la modifica delle identità prima di configurare un server a livello 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 esistere già in Windows.

È necessario attendere la successiva sincronizzazione di identità con Windows prima che le proprietà degli account modificati con questo comando vengano aggiornate. Questo requisito prevede le modifiche da gruppo a utente, da utente a gruppo e da account di dominio ad account locale.

Esempio

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.

Nell'esempio seguente viene illustrato 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. L'aggiornamento dei SID verrà eseguito solo per i nomi di account corrispondenti. 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 costituito da due parti. È prima necessario modificare l'account del servizio da NT AUTHORITY\NETWORK SERVICE a un account di dominio nel nuovo dominio TempSVCe quindi modificare nuovamente l'account in SERVIZIO DI RETE nel 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"

Processi

È 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
retry	Obbligatorio se /dumplog non viene usato. Specifica che il processo più recente verrà riscritto per la raccolta di progetti specificata. Se si usa questa opzione, è necessario usare anche /CollectionName o l'opzione /CollectionID .
dumplog	Obbligatorio se /retry non viene usato. Specifica che l'attività del processo 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 .
CollectionName	Obbligatorio se /CollectionID non viene usato. Specifica il nome della raccolta per cui il processo più recente verrà ritentato (/nuovo tentativo) o registrato (/dumplog). Se si desidera specificare tutte le raccolte, è possibile usare un asterisco (*).
CollectionID	Obbligatorio se /CollectionName non viene utilizzato. Specifica il numero di identificazione della raccolta per cui il processo più recente verrà ritentato (/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.

Commenti

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

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

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

OfflineDetach

Usare il comando offlineDetach per rendere un database di raccolta offline in un database di raccolta offline 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.

Commenti

Questo comando modifica lo schema del database di raccolta specificato e non deve mai essere eseguito nei database usati da una distribuzione di Team Foundation Server. Se i database sono in uso da una distribuzione di Team Foundation 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 Azure DevOps Server. In precedenza questo richiedeva il ripristino di un set completo e coerente di database (configurazione e tutte le raccolte) in un ambiente di gestione temporanea, la configurazione di una distribuzione Azure DevOps Server usando tali database e la disconnessione di una 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 , usando un database di configurazione denominato TFS_PrimaryCollectionTFS_Configuration, con entrambi in un'istanza DI SQL in esecuzione in un server denominato ContosoTemp nell'istanza denominata Backups.

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

Proxy

È possibile usare il comando proxy per aggiornare o modificare le impostazioni usate dal server proxy di Azure DevOps. Il server proxy di Azure DevOps offre il supporto per i team distribuiti per usare il controllo della versione gestendo una cache di 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 per le connessioni a livello di area. Inoltre, non sarà necessario gestire i download né memorizzare nella cache i file di controllo della versione; la gestione dei file è molto chiara per lo sviluppatore che li utilizza. Nel frattempo, eventuali scambi di metadati e caricamenti di file continuano a essere visualizzati in Azure DevOps Server. Se si usa il 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 di 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
add	Aggiunge il server o la raccolta specificata all'elenco del proxy nel file Proxy.config. È possibile eseguire più volte il comando /add per includere più raccolte o più server. Quando si usa /add con una raccolta ospitata in Azure DevOps Services, verranno richieste le credenziali in Azure DevOps Services.
change (modifica)	Modifica le credenziali archiviate come account del servizio per Azure DevOps Services. L'opzione /change viene usata solo per Azure DevOps Services e non deve essere usata per le distribuzioni locali di Azure DevOps Server.
eliminazione	Rimuove il server o la raccolta specificata dall'elenco del proxy nel file Proxy.config.
account	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 è "Servizio account".
continue	Continua l'esecuzione del comando anche se il processo di verifica genera degli avvisi.
Raccolta	Specifica l'URL della raccolta di progetti ospitata in Azure DevOps Services, in `AccountName.DomainName/CollectionName` formato .
account	Specifica il nome dell'account utilizzato come account del servizio per Azure DevOps Services. Se contiene spazi, il nome account deve essere incluso tra virgolette (""). Tutti i caratteri speciali nei nomi account devono essere specificati secondo la sintassi della riga di comando.
account	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)
input	facoltativo. Specifica impostazioni e valori aggiuntivi da usare durante la configurazione del proxy. Ad esempio, i valori per e `GvfsRepositoryName` possono essere usati per `GvfsProjectName` 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.

Commenti

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.

Esempio

Nell'esempio seguente viene illustrato come aggiungere una distribuzione Azure DevOps Server denominata FABRIKAM all'elenco proxy.

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

Nell'esempio seguente viene illustrato 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

Nell'esempio seguente viene illustrato 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é contiene spazi, il nome account è racchiuso tra virgolette.

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 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 solo il database di Analysis Services verrà ricompilato. Se non esiste alcun database per Analysis Services, è necessario usare anche l'opzione /reportingDataSourcePassword .
all	Obbligatorio se /analysisServices non viene usato. Specifica che tutti i database di report e analisi utilizzati da Azure DevOps Server verranno ricompilati.
reportingDataSourcePassword	Obbligatorio se il database TFS_Analysis non esiste. Specifica la password dell'account utilizzato come account delle origini dati per SQL Server Reporting Services (TFSReports). Per altre informazioni, vedere Account di servizio e dipendenze 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.

Commenti

È 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 di Azure DevOps. Per altre informazioni, vedere Aprire la console di amministrazione di Azure DevOps.

Esempio

Nell'esempio seguente viene illustrato 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 utilizzare questo comando quando si ripristina il database di configurazione nel nuovo hardware o in caso di modifica del 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 di , è necessario usare il formato : `ServerName\InstanceName`.
databaseName	Obbligatorio. Specifica il nome del database di configurazione. Per impostazione predefinita, è Tfs_Configuration.

Prerequisiti

Per usare il comando registerDB, è necessario essere membri 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.

Commenti

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:

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

È necessario fornire il nome esatto o l'indirizzo del database di configurazione affinché questo comando funzioni correttamente. Se è necessario modificare il server in cui è archiviato il database, è necessario assicurarsi che Azure DevOps Server punti al nuovo percorso.

Esempio

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

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

RemapDB

Il comando remapDBs reindirizza Azure DevOps Server ai relativi database quando vengono archiviati in più server e si esegue il ripristino, lo spostamento o la modifica della configurazione della distribuzione. Ad esempio, è necessario reindirizzare Azure DevOps Server a qualsiasi database per le raccolte di progetti se sono ospitati in un server o server separato 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
DatabaseName	Specifica il nome del server che ospita il database di cui si desidera 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 utilizzare una virgola per separare più coppie di nomi di server e istanze.
AnalysisInstance	facoltativo. 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	facoltativo. Specifica il nome del database di Analysis Services che si desidera utilizzare con Azure DevOps Server se si dispone di più di un database di questo tipo nel server specificato con l'opzione /AnalysisInstance.
preview	facoltativo. Visualizza le azioni che è necessario eseguire per aggiornare la configurazione.
continue	facoltativo. Specifica che il comando RemapDB deve continuare anche se si verifica un errore durante il tentativo di individuare uno o più database. Se si utilizza 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 Amministratori di Azure DevOps e membro del gruppo di sicurezza sysadmin per tutti i database SQL Server usati da Azure DevOps Server. Per altre informazioni, vedere Informazioni di riferimento sulle autorizzazioni per Azure DevOps Server.

Commenti

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

Nell'esempio seguente viene illustrato come reindirizzare Azure DevOps Server al database TFS_Configurationdi configurazione . Questo database è ospitato nell'istanza ContosoMainTeamDatabasesdenominata . I database della raccolta di progetti vengono archiviati sia ContosoMain\TeamDatabases 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 interrotto l'esecuzione per gli host di distribuzione e raccolta.

TfsConfig repairJobQueue

Prerequisiti

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

Commenti

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 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 Azure DevOps Server. È necessario eseguire questo strumento dal livello applicazione per aggiornare tutti i server in modo che possano usare gli URL.

Per modificare questi URL in modo interattivo o per visualizzare solo 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
publicUrl	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.

Commenti

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 http://contoso.example.com/tfs viene modificato in 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

/Disinstallare

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.

Esempio

Nell'esempio seguente vengono disinstallate tutte le funzionalità Azure DevOps Server dal computer corrente.

TfsConfig setup /uninstall:All

Nell'esempio seguente viene disinstallato il livello applicazione e le funzionalità di compilazione 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 piani di test e 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 elementi di lavoro (WIT).

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

Opzione

Descrizione

/upgradeTestPlans

Obbligatorio a meno che non venga usato /upgradeStatus .

Converte il piano di test e i gruppi di test esistenti in modo che facciano riferimento a piani di test e gruppi di test basati sull'elemento di lavoro. Aggiorna anche i dati di gestione di test esistenti e i collegamenti tra altri elementi di test esistenti, ad esempio punti di test, esecuzioni di test e risultati di test.

/upgradeStatus

Obbligatorio a meno che non venga usato /upgradeTestPlans .

Segnala lo stato di migrazione dei dati di test per il progetto specificato. Indicherà anche se il progetto specificato include 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 desidera eseguire la migrazione dei dati di test o controllare lo stato della migrazione. Questo progetto deve essere definito nella raccolta specificata utilizzando il parametro /collectionName .

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

Prerequisiti

È necessario essere un membro del gruppo di sicurezza Team Foundation Administrators e un amministratore nel server a livello applicazione.

Vedere Impostare le autorizzazioni di amministratore per Azure DevOps Server.

Commenti

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

Prima di 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 per ogni progetto.

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

Usare il comando TCM 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, sarà necessario eseguirlo a sua volta in ogni progetto.

Esempio

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 automatica

Disponibilità dei comandi: Azure DevOps Server 2019

Il comando di installazione automatica è progettato per gli utenti che hanno familiarità con Azure DevOps Server e il processo di configurazione e che devono installare Azure DevOps Server in computer diversi.

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

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

Questo processo consente di configurare Azure DevOps Server dall'inizio al termine senza dover fornire input durante il processo di installazione. Nel caso di più installazioni, questo comando permette anche di garantire l'uso degli stessi parametri di configurazione in tutti i server.

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

Opzione	Descrizione
create	Crea un file di installazione automatica con il nome e i parametri specificati dall'utente.
Configurazione	Configura Azure DevOps Server usando il file e i parametri non distribuiti specificati. È necessario usare /type o /unattendfile con questa opzione.
tipo	Specifica il tipo di configurazione da usare. Quando si usa /configure, è necessario specificare l'opzione /type o /unattendfile, ma non è possibile specificarle entrambe.
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.
input	facoltativo. Se si usa /create, specifica le impostazioni e i valori da usare per la creazione del file di installazione automatica. Se si usa /configure, specifica altre impostazioni e valori da usare insieme al file di installazione automatica. Come alternativa all'uso di /inputs, è possibile modificare manualmente il file di installazione automatica in qualsiasi editor di testo. Ciò è necessario per determinati tipi di input, ad esempio ServiceAccountPassword o PersonalAccessToken, poiché questi valori segreti non possono essere impostati usando il parametro /inputs.
verify	facoltativo. Specifica un'esecuzione della configurazione che completa solo i controlli di verifica sul file di installazione automatica, sugli input e sul tipo di configurazione. Si tratta di un'alternativa all'esecuzione di una configurazione completa.
continue	facoltativo. Specifica che /create o /configure deve continuare anche se vengono visualizzati avvisi dei controlli di verifica.

InstallType	Descrizione
NewServerBasic	Configura i servizi di sviluppo essenziali per Azure DevOps Server. Ciò include controllo del codice sorgente, elementi di lavoro, compilazione e facoltativamente Search.
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 di Azure DevOps Server esistente 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 assicurarsi 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 e di eseguire rapidamente le impostazioni esistenti. Se si vuole modificare le impostazioni esistenti, usare invece il tipo Advanced ApplicationTierOnlyAdvanced.
ApplicationTierOnlyAdvanced	Configurare un nuovo livello applicazione con controllo completo su tutte le impostazioni. Le impostazioni verranno predefinite per i valori esistenti dal database di configurazione fornito. Se si desidera mantenere tutte le impostazioni esistenti, usare invece il tipo ApplicationTierOnlyBasic.
Clone	Configurare una nuova distribuzione 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 assicurarsi che la nuova distribuzione non interferisca con la distribuzione di produzione.
Proxy	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, potrebbero anche essere necessarie altre autorizzazioni di amministrazione.

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

Commenti

Prima di poter usare il comando unattend per configurare Azure DevOps Server, è necessario creare gli account del servizio usati come parte della distribuzione. Occorre anche installare il software richiesto per il tipo di installazione scelto. Ciò include Azure DevOps Server stesso. È necessario installare Azure DevOps Server, ma non è necessario configurarlo perché il comando non aggiornato eseguirà questa operazione.

Il comando unattend configura i componenti di Azure DevOps Server. Non esegue l'installazione iniziale del software, ma configura il software in base alle specifiche dell'utente quando i componenti sono già presenti nel computer.

Esempio

Nell'esempio seguente viene illustrato come creare un file non autorizzato per un'installazione di base di Azure DevOps Server.

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

Nell'esempio il file di installazione automatica viene creato nella stessa directory del comando. Viene creato un file di log come parte del comando e il percorso del file viene restituito nel comando come parte della sua esecuzione.

Nell'esempio seguente viene illustrato 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

Nell'esempio seguente viene illustrato come creare un file non autorizzato per la configurazione di un server proxy di Azure DevOps.

Importante

In questo esempio, se gli amministratori vogliono usare un token di accesso personale per l'autenticazione, sarà necessario modificare manualmente il file per specificare il valore del token di accesso personale. Questa operazione può essere ottenuta aggiungendo una riga per il token di accesso personale nel file di accesso non aggiornato creato, ad esempio: PersonalAccessToken=PersonalAccessTokenValue.

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

Nell'esempio seguente viene illustrato come creare un file non autorizzato per la configurazione di Azure DevOps Server Build in un server usando come account del servizio di compilazione e quindi configurare Azure DevOps Server Build usando FabrikamFiber\BuildSVC tale file non eseguito.

Importante

In questo esempio, dopo aver creato il file di installazione automatica, l'amministratore lo modifica manualmente per specificare la password per l'account del servizio di compilazione. L'aggiunta della password come input con ServiceAccountPassword=Password; 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 è stato configurato FabrikamFiberTFS Azure DevOps Build 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 zip in ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs