Usare TFSConfig per gestire Azure DevOps locale

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]

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.

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.

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

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

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

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

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]

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

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,...]]

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

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.

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

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

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>]

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"

È 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]

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. È inoltre necessario essere 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 progetti nella console di amministrazione di 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 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

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>

Prerequisiti

Per usare il comando columnStoreIndex, è necessario essere un 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 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 sposta un database in un'istanza di 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 TFS_DefaultCollection in un'istanza DI SQL in esecuzione in un server denominato ContosoMain nell'istanza denominata TeamDatabases.

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

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]]

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

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]

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

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>

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

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

Prerequisiti

Per usare il comando identità, è necessario essere membro 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 di destinazione o gli account devono già esistere 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 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 tra 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 esiste come Contoso1\hholt e ContosoPrime\hholt, l'account hholt SID verrà modificato nel SID per ContosoPrime\hholt. Se l'account non esiste, il ContosoPrime\hholt 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 del NT AUTHORITY\NETWORK SERVICE 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 di tutto si modifica l'account del servizio da NT AUTHORITY\NETWORK SERVICE a un account di dominio nel nuovo dominio TempSVCe quindi si modifica l'account in SERVIZIO DI RETE nel server nel nuovo dominio. Il database di configurazione è ospitato nel server denominato nell'istanza TeamDatabases denominata ContosoMain 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"

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

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

Prerequisiti

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

Commenti

Per riprovare 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"

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

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

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 su database che vengono 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 di Azure DevOps Server. In precedenza, è necessario ripristinare un set completo e coerente di database (configurazione e tutte le raccolte) in un ambiente di staging, configurare una distribuzione Azure DevOps Server usando tali database e scollegare 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 della raccolta scollegato può quindi essere collegato a qualsiasi distribuzione Azure DevOps Server in una versione appropriata.

Esempio

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

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

È possibile usare il comando proxy per aggiornare o modificare le impostazioni usate da Azure DevOps Proxy Server. Azure DevOps Proxy Server offre supporto per i team distribuiti per l'uso del 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 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 non solo gestire 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 Riferimento al comando di controllo della versione di Azure DevOps.

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

Prerequisiti

Per usare il comando proxy , è necessario essere un membro del gruppo di sicurezza Azure DevOps Administrators e 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 un prompt 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"

Nell'esempio seguente viene illustrato come aggiungere un repository Git da usare con GVFS.

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

È 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]

Prerequisiti

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

• Gruppo di sicurezza Azure DevOps Administrators e 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 per 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.

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>

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 a livello di 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 questo 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

Il comando remapDBs reindirizza Azure DevOps Server ai relativi database quando vengono archiviati in più server e si sta ripristinando, spostando o modificando in caso contrario la 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 separati dal database di configurazione. È anche necessario reindirizzare Azure DevOps Server al server o ai server che eseguono SQL Server Analysis Services o SQL Server Reporting Services se questi 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]

Prerequisiti

Per usare il comando remapDBs, è necessario essere un membro del gruppo di sicurezza Azure DevOps Administrators e un 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 diverse di SQL Server 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

Si usa il comando repairJobQueue per correggere i processi pianificati che hanno interrotto l'esecuzione per gli host della distribuzione e della raccolta.

TfsConfig repairJobQueue

Prerequisiti

Per usare il comando repairJobQueue , è necessario essere un membro del gruppo amministratori locali 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 Azure DevOps Server.

Commenti

In genere si userà il comando repairJobQueue se si noterà che i processi pianificati non vengono eseguiti.
Il comando non accetta argomenti e richiede la configurazione della distribuzione Azure DevOps Server.

Esempio

TfsConfig repairJobQueue

È possibile usare il comando impostazioni per automatizzare le modifiche apportate al localizzatore di risorse uniforme (URL) 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 semplicemente le impostazioni correnti, è possibile usare la console di amministrazione per Azure DevOps. Vedere Informazioni di riferimento rapido sulle attività amministrative.

TfsConfig settings [/publicURL:URL]

Prerequisiti

È necessario essere un membro 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 impostazioni 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

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

Se la migrazione automatica ha esito negativo, usare il comando TCM per aggiornare manualmente i piani di test e i gruppi di test ai rispettivi tipi di elemento di lavoro.

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

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

Il server a livello di applicazione deve essere aggiornato alla versione più recente di Azure DevOps Server 2019 per usare questo comando.

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, tale percorso è: drive:\%programfiles%\TFS 12.0\Tools.

Si usa il comando TCM solo nel caso in cui la migrazione automatica dei dati di test esistenti abbia esito negativo.

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 l'aggiornamento TCM TFSConfig Per determinare lo stato della migrazione.

Eseguire il comando TCM per un singolo progetto. Se è necessario aggiornare più di un progetto, sarà necessario eseguirlo in ogni progetto a sua volta.

Esempio

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

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

Disponibilità dei comandi: Azure DevOps Server 2019

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

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

Usare l'opzione /create per creare un file non autorizzato. 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]

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.

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.

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

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

TfsConfig zipLogs

TfsConfig zipLogs