TFSConfig gebruiken om Azure DevOps on-premises te beheren

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

U kunt het opdrachtregelprogramma TFSConfig gebruiken om diverse beheeracties uit te voeren voor uw on-premises Azure DevOps-implementatie.

TFSConfig kan worden uitgevoerd vanaf elke computer waarop Azure DevOps Server is geïnstalleerd.

Locatie van opdrachtregelhulpprogramma

Azure DevOps-opdrachtregelprogramma's worden geïnstalleerd in de map /Tools van een Azure DevOps-toepassingslaagserver.

• 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

Vereiste voorwaarden

Voor veel opdrachten die correct werken, moet TFSConfig verbinding kunnen maken met de verschillende servers en services die deel uitmaken van uw TFS-implementatie. De gebruiker die TFSConfig uitvoert, moet beheerdersmachtigingen hebben voor dezelfde servers en services. De vereisten voor specifieke opdrachten worden hieronder beschreven.

Veel TFSConfig-opdrachten moeten worden uitgevoerd vanaf een opdrachtprompt met verhoogde bevoegdheid, zelfs als de actieve gebruiker beheerdersreferenties heeft. Als u een opdrachtprompt met verhoogde bevoegdheid wilt openen, klikt u op Start, klikt u met de rechtermuisknop op Opdrachtprompt en klikt u vervolgens op Als administrator uitvoeren. Zie voor meer informatie: Gebruikersaccountbeheer.

U kunt ook interactief beheeracties uitvoeren met behulp van de beheerconsole voor Azure DevOps Server. Raadpleeg snelzoekgids voor beheertaken.

Opdrachten weergeven en hulp krijgen

Als u een volledige lijst met TFSConfig-opdrachten wilt weergeven, gebruikt u de Help-opdracht :

TFSConfig help

Als u hulp wilt krijgen voor een afzonderlijke opdracht, gebruikt u de Help-opdracht en geeft u de naam op van de opdracht waarmee u hulp wilt. Als u bijvoorbeeld hulp wilt krijgen voor de opdracht Accounts :

TFSConfig help accounts

Rekeningen

Gebruik de opdracht Accounts om deze Azure DevOps Server-serviceaccounts te beheren.

• het Azure DevOps Server-serviceaccount
• het gegevensbronnenaccount voor SQL Server Reporting Services
• het azure DevOps Proxy Server-serviceaccount

U kunt deze opdracht ook gebruiken om het eigendom van de Azure DevOps Server-databases te wijzigen.

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

Operatie	Beschrijving
Wachtwoord Bijwerken	Hiermee wijzigt u het wachtwoord van een account dat wordt gebruikt als een serviceaccount. Wijzigt het bestaande account en alle accounttypen die als het opgegeven account worden uitgevoerd.
Veranderen	Hiermee wijzigt u het account dat wordt gebruikt als het serviceaccount. Voegt het nieuwe account toe aan de benodigde resources en groepen, verleent de vereiste machtigingen en stelt vervolgens de service in om het te gebruiken. Hiermee wordt het oude account niet uit de resources verwijderd. Als u de optie accountType niet gebruikt, wordt het serviceaccount voor de toepassingslaag gewijzigd.
Toevoegen	Voegt alleen het nieuwe account toe aan de benodigde resources. Handig voor NLB-scenario's. Gebruik de continue vlag als sommige verzamelingen niet bereikbaar zijn. Toevoegen kan later opnieuw worden uitgevoerd om gemiste verzamelingen bij te werken. Hiermee voegt u een account toe aan de groepen die vereist zijn voor het gebruik van het account als een serviceaccount.
Stel in	Hiermee stelt u de service alleen in om een account te gebruiken dat al aan de resources is toegevoegd. Handig voor NLB-scenario's.
Verwijderen	Hiermee verwijdert u het account uit alle resources. Voorzorgsmaatregelen moeten worden gebruikt bij het verwijderen van een account, omdat dit ertoe kan leiden dat andere servers de service geweigerd krijgen.
Eigenaar resetten	Als de databases worden hersteld als onderdeel van een verplaatsing, kloon of herstel na noodgevallen, kan de eigenaar van de database overschakelen naar de beheerder die de server herstelt. Deze optie doorloopt alle databases en stelt de dbo-aanmelding in bij de huidige eigenaar.

AccountType	Beschrijving
AdminConsole	Gebruikers van de beheerconsole zijn gebruikers waaraan de minimale machtigingen voor verschillende resources zijn verleend om de console te gebruiken.
Applicatielaag	Hiermee wijzigt u het serviceaccount in de appPool voor de belangrijkste webservices. (TFSService)
Tussenpersoon	Hiermee wijzigt u het serviceaccount in de appPool voor de proxywebservices. (TFSProxy)
RapportageGegevensbron	Hiermee wijzigt u het account dat de rapporten gebruiken om toegang te krijgen tot de rapportagegegevens. (TFSReports)

De standaardwaarde is ApplicationTier.

De sqlInstance en databaseName zijn alleen geschikt voor gebruik bij het toevoegen van een account aan databases voordat de toepassingslaag is geconfigureerd. Dit is voornamelijk handig in scenario's voor herstel na noodgevallen waarbij een ander account nodig is voordat u de wizard AT Only-configuratie uitvoert.

De optie Doorgaan wordt gebruikt bij het toevoegen of wijzigen van een account. Voor deze bewerkingen wordt het account gewijzigd in elke verzamelingsdatabase. Als 'continue' wordt meegegeven, zal het doorgaan als een verzameling onbereikbaar is. Deze kan opnieuw worden uitgevoerd wanneer ze bereikbaar zijn.

Notitie

De accounts moeten de indeling domainName\userName hebben. Voor systeemaccounts moet u aanhalingstekens gebruiken rond de volledige accountnaam (bijvoorbeeld 'NT Authority\Network Service'). Voor systeemaccounts is geen wachtwoord vereist.

Maatstaf	Beschrijving
Account	Hiermee geeft u de naam op van het account dat u wilt toevoegen, wijzigen of verwijderen uit een accounttype waarnaar wordt verwezen, zoals /AccountType:ApplicationTier.
Wachtwoord	Hiermee wordt het wachtwoord van het serviceaccount gespecificeerd. Deze parameter is optioneel als u een systeemaccount of een account gebruikt dat geen wachtwoord heeft, zoals Netwerkservice.
sqlInstance	Alleen gebruikt met /ResetOwner. Hiermee geeft u de naam op van de server waarop SQL Server wordt uitgevoerd en de naam van het exemplaar als u een ander exemplaar dan het standaardexemplaar wilt gebruiken. U moet de naam en de instantie opgeven in de volgende indeling: ServerName\InstanceName.
databaseNaam	Alleen gebruikt met /ResetOwner. Hiermee geeft u de naam op van de database waarvan u het eigendom wilt wijzigen. Met deze opdracht stelt u het eigendom van de database die u opgeeft opnieuw in op het account waaronder u de opdracht uitvoert.
voortzetten	Werkt alle groepen bij die niet beschikbaar zijn wanneer u de opdracht uitvoert. Deze optie wordt meestal gebruikt in NLB-scenario's.

Vereiste voorwaarden

Als u de opdracht Accounts wilt gebruiken, moet u lid zijn van:

• de beveiligingsgroep Azure DevOps Administrators
• de rol sysadmin voor alle SQL Server-exemplaren die door uw Azure DevOps Server-exemplaar worden gebruikt.

Als u de optie /proxy gebruikt, moet u een beheerder zijn op de proxyserver.

Zie De machtigingsreferentie voor Azure DevOps Server voor meer informatie.

Opmerkingen

Gebruik de opdracht Accounts om wijzigingen in de serviceaccounts, databases en serviceaccountgroepen van Azure DevOps Server te automatiseren. U kunt accounts configureren die u al hebt gemaakt, maar u kunt geen accounts maken.

Voordat u het domein of de werkgroep van een account wijzigt, moet het account de machtiging "Account is gevoelig en kan niet worden gedelegeerd" hebben op de server van de applicatielaag. Zie deze pagina op de Website van Microsoft voor meer informatie: Gedelegeerde verificatie inschakelen.

De opdracht Accounts ondersteunt on-premises Azure DevOps Server-implementaties. Zie Eigendom van het account wijzigen als u de accounteigenaar van een Azure DevOps Services-account wilt wijzigen.

Voorbeelden

Wijzig het serviceaccount van gegevensbronnen voor Reporting Services in een nieuw account in het Contoso-domein, Contoso\NewAccount, en het wachtwoord, in Password.

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

Voeg het netwerkservicesysteemaccount toe aan de serviceaccountgroepen voor Azure DevOps Server (systeemaccounts hebben geen wachtwoorden).

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

Wijzig het eigendom van de TFS_Warehouse database op de ContosoMain SQL Server in de TeamDatabases genaamde instantie naar het gebruikersaccount waaronder u de opdracht uitvoert.

Notitie

U kunt niet opgeven welk account moet worden ingesteld als de eigenaar van de databases wanneer u deze opdracht gebruikt. De eigenaar wordt ingesteld op het account waaronder u de opdracht uitvoert.

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

---

ProjectrapportenToevoegen

Notitie

De opdracht addProjectReports is beschikbaar met TFS 2017.1 en nieuwere versies.

U gebruikt de opdracht addProjectReports om rapporten toe te voegen of te overschrijven voor een bestaand teamproject.

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

Optie	Beschrijving
verzameling	Verplicht. URL van Teamprojectcollectie.
teamproject	Verplicht. Hiermee geeft u de naam van het teamproject.
sjabloon	Verplicht. Specificeert de naam van de processjabloon. Beschikbare opties zijn Agile, CMMI en Scrum.
kracht	Facultatief. Hiermee wordt aangegeven dat rapporten moeten worden overschreven als ze al bestaan.

Vereiste voorwaarden

Als u de opdracht addProjectReports wilt gebruiken, moet u gemachtigd zijn om TFSConfig uit te voeren en rapporten te uploaden naar de Reporting Service.

Opmerkingen

U gebruikt de opdracht addProjectReports wanneer uw project geen rapporten heeft of als u de rapporten wilt bijwerken die zijn gedefinieerd voor een proces.

Mogelijk moet u deze opdracht gebruiken wanneer:

• Het project is gemaakt in de Azure DevOps-portal en niet vanuit Visual Studio
• Het project is gemaakt vanuit Visual Studio, maar rapportage is niet geconfigureerd in Azure DevOps Server.

Als u rapporten in uw project wilt overschrijven met standaardrapporten omdat u Azure DevOps Server hebt bijgewerkt, waardoor oude rapporten in uw project niet meer compatibel zijn, gebruikt u de optie /force. Als u rapporten hebt aangepast, moet u een back-up maken voordat u dit doet.

Zie Rapporten toevoegen aan een project voor meer informatie over het toevoegen van rapporten aan een on-premises Azure DevOps Server.

Voorbeeld

In het volgende voorbeeld ziet u hoe u Agile-rapporten toevoegt aan MyProject een project in http://myTfsServer:8080/tfs/DefaultCollection projectverzameling.

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

---

Authenticatie

Met de opdracht Verificatie wordt het netwerkverificatieprotocol gewijzigd dat door de Azure DevOps Server-toepassingslaag of proxywebsite wordt gebruikt.

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

Optie

Beschrijving

/viewAll

Geeft de huidige verificatie-instellingen voor Azure DevOps Server weer.

/provider: { NTLM | Onderhandelen }

Hiermee geeft u de verificatieprovider op die u wilt configureren voor de website.

• NTLM: het NTML-verificatieprotocol gebruiken
• Onderhandelen: Het verificatieprotocol negotiate (Kerberos) gebruiken

/siteType

Hiermee geeft u de website (toepassingslaag of proxy) op waarvan u het netwerkverificatieprotocol wilt wijzigen. De toepassingslaag is de standaardlaag.

Vereiste voorwaarden

Als u de verificatieopdracht wilt gebruiken, moet u lid zijn van de beveiligingsgroep Azure DevOps Administrators en een lokale beheerder op de server of proxyserver van de toepassingslaag, afhankelijk van de waarde van de optie siteType .

Opmerkingen

De verificatieopdracht wordt gebruikt door een beheerder die het netwerkverificatieprotocol wil wijzigen voor een of meer websites waarop Azure DevOps Server afhankelijk is. De beheerder voert deze opdracht uit vanuit de toepassingslaag om die websites bij te werken waarvoor een wijziging in het netwerkverificatieprotocol is vereist. De opdracht wijzigt de eigenschap NTAuthenticationProviders in de IIS-metabase.

Voordat u de verificatieopdracht gebruikt om het verificatieprotocol te wijzigen, kunt u de opdracht uitvoeren met de optie /viewAll om te zien wat de bestaande instellingen zijn.

Voorbeeld

In het volgende voorbeeld wordt de huidige waarde weergegeven die is toegewezen voor het netwerkverificatieprotocol.

TFSConfig Authentication /viewAll

---

Certificaten

Gebruik de opdracht Certificaten om te wijzigen hoe certificaten worden geconfigureerd voor clientverificatie in een implementatie van Azure DevOps Server die gebruikmaakt van HTTPS, secure sockets layer (SSL) en certificaten.

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

Optie	Beschrijving
machine	Hiermee geeft u op dat de lijst met certificaten afkomstig is van de context van de lokale computer in plaats van de huidige gebruikerscontext.
uitschakelen	Hiermee geeft u op dat de certificaatinstelling voor clientverificatie wordt uitgeschakeld.
automatisch selecteren	Hiermee geeft u op dat een certificaat automatisch wordt geselecteerd in de lijst met certificaten. Het venster Clientcertificaten beheren wordt niet geopend.
noprompt	Hiermee geeft u op dat het venster Clientcertificaten beheren niet wordt geopend wanneer de opdracht Certificaten wordt uitgevoerd.
vingerafdruk	Hiermee geeft u op dat het certificaat dat overeenkomt met de opgegeven vingerafdruk wordt gebruikt. U kunt meer dan één certificaat opgeven door afzonderlijke vingerafdrukken te scheiden met een komma.

Vereiste voorwaarden

Als u de opdracht certificaten wilt gebruiken, moet u lid zijn van de beveiligingsgroep Azure DevOps Administrators en de lokale groep Administrators op de computer van waaruit u de opdracht uitvoert. Zie De machtigingsreferentie voor Azure DevOps Server voor meer informatie.

Opmerkingen

De certificaatopdracht selecteert standaard automatisch een clientcertificaat in de lijst met certificaten voor de huidige gebruiker. U kunt echter de opties voor de opdracht gebruiken om een specifiek certificaat of certificaten op te geven vanuit de huidige gebruikerscontext of vanuit de context van de lokale computer.

Voordat u de opdracht certificaten gebruikt, moet u eerst de servers in uw implementatie van Azure DevOps Server configureren om certificaten te gebruiken. Zie HTTPS instellen met SSL (Secure Sockets Layer) voor Azure DevOps Server voor meer informatie.

U gebruikt de opdracht certificaten om de clientcertificaten te configureren die worden gebruikt door een implementatie van Azure DevOps Server die is geconfigureerd voor het gebruik van HTTPS/SSL en certificaten. Als u de opdracht Certificaten zonder opties gebruikt, wordt automatisch een clientcertificaat geselecteerd in de huidige gebruikerscontext van waaruit u de opdracht uitvoert.

Voorbeelden

In het volgende voorbeeld ziet u hoe u het lokale computercertificaat met de vingerafdruk aa bb cc dd ee zonder prompt opgeeft.

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

In het volgende voorbeeld wordt getoond hoe u het automatisch selecteren van een clientcertificaat uit het huidige gebruikersarchief bepaalt.

TfsConfig certificates /autoselect

---

ChangeServerID

Met de opdracht changeServerID worden de GUID's gewijzigd die zijn gekoppeld aan de databases voor Azure DevOps Server. GUID's moeten uniek zijn binnen een implementatie van Azure DevOps Server. Als meer dan één database dezelfde GUID heeft, kan uw implementatie instabiel of onbruikbaar worden. U kunt de GUID voor de configuratiedatabase, de GUID's voor alle projectverzamelingsdatabases in de implementatie of beide wijzigen.

Hoewel u deze opdracht doorgaans niet gebruikt in dagelijkse bewerkingen, kunt u deze opdracht in de volgende omstandigheden gebruiken:

• U hebt uw implementatie hersteld naar nieuwe hardware, de oude implementatie is nog steeds operationeel en u wilt beide implementaties gebruiken. Dit scenario wordt soms aangeduid als het klonen van de server.

• U wilt een software-update of een hardwareconfiguratie testen op een kopie van de implementatie, zodat u niet het risico loopt dat uw productieomgeving wordt onderbroken.

• U wilt het herstel van databases volledig testen op nieuwe hardware in een testlab of een afzonderlijke omgeving om ervoor te zorgen dat uw implementatie kan worden hersteld.

• U moet de GUID voor een verzamelingsdatabase opnieuw instellen nadat u deze hebt verplaatst naar een andere implementatie waarvoor die GUID al is gereserveerd.

Notitie

De opdracht changeServerID is niet omkeerbaar. Nadat een GUID is gewijzigd, kunt u deze wijziging niet ongedaan maken, behalve door een eerdere versie van die database te herstellen.

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

Optie	Beschrijving
sqlInstance	Verplicht. Hiermee geeft u de naam op van de server waarop SQL Server wordt uitgevoerd en de naam van het exemplaar als u een ander exemplaar dan het standaardexemplaar wilt gebruiken. Als u een exemplaar opgeeft, moet u de volgende indeling gebruiken: ServerName\InstanceName
databaseNaam	Verplicht. Hiermee geeft u de naam van de configuratiedatabase voor Azure DevOps Server. De naam van deze database is standaard TFS_ConfigurationDB.
projectCollectionsOnly	Hiermee geeft u op dat alleen de GUID's voor verzamelingen worden gewijzigd.
configDBOnly	Hiermee geeft u op dat alleen de GUID voor de configuratiedatabase wordt gewijzigd.
collectieNaam	Met deze optie specificeert u om een nieuwe exemplaar-id te maken voor de specifieke collectie, maar niet voor de Azure DevOps-instantie en andere collecties.

Vereiste voorwaarden

Als u de opdracht changeServerID wilt gebruiken, moet u lid zijn van de beveiligingsgroep Azure DevOps Administrators en lid zijn van de beveiligingsrol sysadmin voor alle SQL Server-exemplaren die door Azure DevOps Server worden gebruikt. Zie De machtigingsreferentie voor Azure DevOps voor meer informatie.

Opmerkingen

U gebruikt de opdracht changeServerID om een discrete duplicaat te maken van een implementatie van Azure DevOps Server voor test- of kloondoeleinden. Nadat u de opdracht changeServerID hebt gebruikt, moet u clients doorsturen om een verbinding met de gewijzigde server te maken voordat deze kan worden gebruikt.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de GUID's van alle databases in de Contoso1-implementatie van Azure DevOps Server wijzigt, waarbij de configuratiedatabase wordt gehost op de server met de naam ContosoMain op het benoemde exemplaar TeamDatabases in SQL Server.

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

---

CodeIndex

Gebruik de opdracht codeIndex om code-indexering op Azure DevOps Server te beheren. U kunt bijvoorbeeld de index opnieuw instellen om CodeLens-gegevens op te lossen of indexering uitschakelen om prestatieproblemen met de server te onderzoeken.

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

Optie	Beschrijving
indexeringsstatus	De status en configuratie van de code-indexeringsservice weergeven.
setIndexing	op: Begin met het indexeren van alle wijzigingensets. uit: Stop met het indexeren van alle wijzigingensets. keepupOnly: Stop het indexeren van eerder gemaakte wijzigingensets en begin alleen met het indexeren van nieuwe wijzigingensets.
ignoreList	Hiermee geeft u een lijst met codebestanden en de bijbehorende paden op die u niet wilt indexeren. toevoegen: Voeg het bestand toe dat u niet wilt indexeren in de lijst met genegeerde bestanden. verwijderen: Verwijder het bestand dat u wilt indexeren uit de lijst met genegeerde bestanden. removeAll: Wis de lijst met genegeerde bestanden en begin met het indexeren van alle bestanden. weergave: Bekijk alle bestanden die niet worden geïndexeerd. ServerPath: Hiermee geeft u het pad naar een codebestand. U kunt het jokerteken (*) aan het begin, einde of beide uiteinden van het serverpad gebruiken.
listLargeFiles	Geeft het opgegeven aantal bestanden weer dat groter is dan de opgegeven grootte in KB. Vervolgens kunt u de optie /ignoreList gebruiken om deze bestanden uit te sluiten van indexering. Hiervoor hebt u Team Foundation Server 2013 met Update 3 nodig.
alles opnieuw indexeren	Wis eerder geïndexeerde gegevens en start de indexering opnieuw.
vernietigCodeIndex	Verwijder de code-index en verwijder alle geïndexeerde gegevens. Er is geen bevestiging vereist als u de optie /noPrompt gebruikt.
tijdelijke gegevensgroottelimiet	Beheer hoeveel tijdelijke gegevens CodeLens maakt bij het verwerken van wijzigingsets. De standaardlimiet is 6 GB (2 GB in update 5). weergave: De huidige groottelimiet weergeven. SizeInGBs: wijzig de groottelimiet. uitschakelen: Verwijder de groottelimiet. Deze limiet wordt gecontroleerd voordat CodeLens een nieuwe wijzigingenset verwerkt. Als tijdelijke gegevens deze limiet overschrijden, onderbreekt CodeLens de verwerking van eerdere wijzigingensets, niet nieuwe. CodeLens start de verwerking opnieuw nadat de gegevens zijn opgeschoond en vallen onder deze limiet. Opschonen wordt automatisch één keer per dag uitgevoerd. Dit betekent dat tijdelijke gegevens deze limiet kunnen overschrijden totdat opschonen wordt uitgevoerd. Hiervoor hebt u Team Foundation Server 2013 met Update 4 nodig.
indexgeschiedenisperiode	Bepalen hoe lang uw wijzigingsgeschiedenis moet worden geïndexeerd. Dit is van invloed op hoeveel geschiedenis CodeLens u laat zien. De standaardlimiet is 12 maanden. Dit betekent dat CodeLens alleen uw wijzigingsgeschiedenis van de afgelopen 12 maanden weergeeft. weergave: Het huidige aantal maanden weergeven. all: Indexeer alle wijzigingsgeschiedenis. NumberOfMonths: Wijzig het aantal maanden dat wordt gebruikt om de wijzigingsgeschiedenis te indexeren. Hiervoor hebt u Team Foundation Server 2013 met Update 4 nodig.
collectieNaam	Hiermee geeft u de naam van de projectverzameling waarop de opdracht CodeIndex moet worden uitgevoerd. Vereist als u /CollectionId niet gebruikt.
collectie-ID	Hiermee geeft u het identificatienummer op van de projectverzameling waarop de opdracht CodeIndex moet worden uitgevoerd. Vereist als u /CollectionName niet gebruikt

Vereiste voorwaarden

Als u de opdracht codeIndex wilt gebruiken, moet u lid zijn van de beveiligingsgroep Azure DevOps Administrators. Zie de machtigingsreferentie voor Azure DevOps Server.

Voorbeelden

De indexeringsstatus en configuratie van de code bekijken:

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

Om te beginnen met het indexeren van alle wijzigingensets:

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

Als u het indexeren van eerder gemaakte wijzigingensets wilt stoppen en alleen nieuwe wijzigingensets wilt indexeren:

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

U kunt maximaal 50 bestanden vinden die groter zijn dan 10 kB:

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

Als u een specifiek bestand wilt uitsluiten van indexering en dit wilt toevoegen aan de lijst met genegeerde bestanden:

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

Als u alle bestanden wilt zien die niet zijn geïndexeerd:

TfsConfig codeIndex /ignoreList:view

Eerder geïndexeerde gegevens wissen en indexering opnieuw starten:

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

Sla alle geschiedenis van wijzigingen op:

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

Als u de groottelimiet voor tijdelijke CodeLens-gegevens wilt verwijderen en wilt doorgaan met indexeren, ongeacht de tijdelijke gegevensgrootte:

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

Volg deze stappen om de code-index te verwijderen met bevestiging:

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

---

Verzameling

U kunt de opdracht verzameling gebruiken om een projectverzameling toe te voegen, los te koppelen of te verwijderen uit een implementatie van Azure DevOps Server. U kunt ook de verzamelingsopdracht gebruiken om de database van een bestaande verzameling te dupliceren, de naam ervan te wijzigen en deze toe te voegen aan de implementatie. Dit proces wordt soms aangeduid als het klonen van een verzameling.

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

Optie	Beschrijving
bijvoegen	Vereist als er geen /loskoppelen of /verwijderen wordt gebruikt. Als u deze optie opgeeft, moet u ook de optie /collectionDB gebruiken. Als optie kunt u ook /collectionName en /clone gebruiken met deze optie. Als u de optie /attach gebruikt, wordt de opgegeven verzamelingsdatabase toegevoegd aan uw implementatie van Azure DevOps Server.
maken	Hiermee maakt u een verzameling.
Loskoppelen	Vereist als /attach of /delete niet wordt gebruikt. Als u deze optie opgeeft, moet u ook de optie /collectionName gebruiken. Als u de optie /loskoppelen gebruikt, wordt de database voor de opgegeven verzameling gestopt en wordt de verzameling losgekoppeld van uw implementatie van Azure DevOps Server.
verwijderen	Vereist als /loskoppelen of /aankoppelen niet wordt gebruikt. Als u deze optie opgeeft, moet u ook de optie /collectionName gebruiken. Als u de optie /delete gebruikt, wordt de database voor de opgegeven verzameling gestopt en wordt de verzameling permanent losgekoppeld van Azure DevOps Server. U kunt de verzamelingsdatabase niet opnieuw koppelen aan deze of een andere implementatie.
Collectienaam	Hiermee geeft u de naam van de projectverzameling. Als de naam van de verzameling spaties bevat, moet u de naam tussen aanhalingstekens plaatsen (bijvoorbeeld 'Mijn verzameling'). Vereist als /loskoppelen of /delete wordt gebruikt. Als u deze optie gebruikt met /loskoppelen of /verwijderen, wordt hiermee de verzameling opgegeven die wordt losgekoppeld of verwijderd. Als u deze optie met /attach gebruikt, wordt er een nieuwe naam voor de verzameling opgegeven. Als u deze optie gebruikt met zowel /attach als /clone, geeft deze de naam op voor de gedupliceerde verzameling.
CollectionDB	Vereist als /attach wordt gebruikt. Met deze optie geeft u de naam op van de server waarop SQL Server wordt uitgevoerd en de naam van de verzamelingsdatabase die op die server wordt gehost.
Servernaam	Hiermee geeft u de naam op van de server die als host fungeert voor de configuratiedatabase voor Azure DevOps Server en de naam van het exemplaar als u een ander exemplaar wilt gebruiken dan het standaardexemplaren. Als u een exemplaar opgeeft, moet u de volgende indeling gebruiken: ServerName\InstanceName
DatabaseNaam	Hiermee geeft u de naam van de configuratiedatabase. De naam van deze database is standaard TFS_ConfigurationDB.
kloon	Als u deze optie opgeeft, wordt de oorspronkelijke verzamelingsdatabase als kloon in SQL Server gekoppeld en wordt deze database gekoppeld aan Azure DevOps Server. Deze optie wordt voornamelijk gebruikt als onderdeel van het splitsen van een projectverzameling.

Hint

Met de optie /delete wordt de verzamelingsdatabase niet uit SQL Server verwijderd. Nadat u de verzamelingsdatabase hebt verwijderd uit Azure DevOps Server, kunt u de database handmatig verwijderen uit SQL Server.

Vereiste voorwaarden

Als u de opdracht Verzamelingen wilt gebruiken, moet u lid zijn van de beveiligingsgroep Team Foundation Administrators en de lokale groep Administrators op de computer waarop TfsConfig wordt uitgevoerd. U moet ook lid zijn van de beveiligingsrol sysadmin voor alle exemplaren van SQL Server die worden gebruikt door Azure DevOps Server-databases. Als uw implementatie is geïntegreerd met SharePoint en u de optie /delete gebruikt, moet u ook lid zijn van de groep Farmbeheerders voor de SharePoint-farm waaruit u de siteverzameling verwijdert.

Zie De machtigingsreferentie voor Azure DevOps Server voor meer informatie.

Opmerkingen

Als u verzamelingen interactief wilt beheren of een verzameling wilt maken, kunt u het knooppunt Projectverzamelingen gebruiken in de beheerconsole voor Azure DevOps. Zie Projectverzamelingen beheren.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de Contoso Summer Intern Projects projectverzameling definitief verwijdert uit een implementatie van 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.

In het volgende voorbeeld ziet u hoe u de projectverzameling dupliceren, een Contoso Summer Interns Projects naam Contoso Winter Interns Projectsgeeft en de dubbele verzameling koppelt aan de implementatie van Azure DevOps Server.

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

---

Kolomopslagindex

Notitie

Beschikbaarheid van opdrachten: vereist TFS 2015.2 en nieuwere versies.

U gebruikt de opdracht columnStoreIndex om kolomopslagindexen in of uit te schakelen voor de databases die worden gebruikt door uw Azure DevOps Server-implementatie.

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

Optie	Beschrijving
Ingeschakeld	Hiermee geeft u op of u de kolomarchiefindex voor het opgegeven SQL-exemplaar en de opgegeven SQL-database inschakelt of uitschakelt.
sqlInstance	Hiermee geeft u de naam op van de server die als host fungeert voor de database waarvoor de kolomarchiefindex wordt ingeschakeld of uitgeschakeld, en de naam van het exemplaar als een ander exemplaar dan de standaardwaarde wordt gebruikt. Als u een exemplaar opgeeft, moet u de volgende indeling gebruiken: ServerName\InstanceName
databaseNaam	Hiermee geeft u de naam op van de database waarvoor de kolomarchiefindex wordt ingeschakeld of uitgeschakeld.

Vereiste voorwaarden

Als u de opdracht columnStoreIndex wilt gebruiken, moet u lid zijn van de sysadmin-rol voor het opgegeven SQL Server-exemplaar.

Opmerkingen

Normaal gesproken gebruikt u de opdracht columnStoreIndex als u een database verplaatst van een SQL-exemplaar dat de index van het kolomarchief ondersteunde naar een database die dat niet heeft gedaan. In dit geval moet u alle indexen van het kolomarchief uitschakelen voordat u de databases kunt verplaatsen. Als u een database terugzet naar een SQL-exemplaar dat de kolomopslagindex ondersteunt, wilt u mogelijk de index van het kolomarchief opnieuw inschakelen om ruimte te besparen en betere prestaties te verkrijgen.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de kolomarchiefindex inschakelt voor een database met de naam TFS_DefaultCollection op een SQL-exemplaar dat draait op een server genaamd ContosoMain in het benoemde exemplaar TeamDatabases.

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

---

ConfigureMail

Configureer de server waarop Azure DevOps Server wordt uitgevoerd om een bestaande SMTP-server te gebruiken voor e-mailwaarschuwingen.

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

Optie	Beschrijving
VanEmailAdres	Hiermee geeft u het adres op van waaruit e-mailmeldingen moeten worden verzonden van Azure DevOps Server voor een check-in, werkitem dat aan u is toegewezen of andere meldingen. Dit adres wordt ook gecontroleerd op geldigheid en, afhankelijk van uw serverconfiguratie, moet mogelijk een geldig e-mailaccount op de e-mailserver vertegenwoordigen. Als het adres niet bestaat of niet geldig is, wordt het standaard-e-mailadres gebruikt.
SmtpHost	Hiermee geeft u de naam op van de server die als host fungeert voor de e-mailserver.

Vereiste voorwaarden

Als u de opdracht configureMail wilt gebruiken, moet u lid zijn van de beveiligingsgroep Team Foundation Administrators op de Server van de Azure DevOps-toepassingslaag. Voor meer informatie, zie Machtigingsreferentie voor Azure DevOps Server

Opmerkingen

U kunt ook de beheerconsole gebruiken om Azure DevOps Server te configureren voor het gebruik van een SMTP-server.

Voorbeeld

In het volgende voorbeeld ziet u de syntaxis die wordt gebruikt om het 'from' e-mailadres als TFS@contoso.com en de SMTP-mailserver als ContosoMailServer te configureren.

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

---

Databasecompressie

U gebruikt de opdracht dbCompression om databasepaginacompressie in of uit te schakelen voor de databases die door uw Azure DevOps Server-implementatie worden gebruikt.

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

Optie	Beschrijving
pageCompression	Hiermee geeft u op of u paginacompressie voor het opgegeven SQL-exemplaar en de database inschakelt of uitschakelt.
sqlInstance	Hiermee geeft u de naam op van de server die als host fungeert voor de database waarvoor paginacompressie wordt ingeschakeld of uitgeschakeld, en de naam van het exemplaar als een ander exemplaar dan de standaardwaarde wordt gebruikt. Als u een instantie specificeert, moet u het volgende format gebruiken: ServerName\InstanceName
databaseNaam	Hiermee geeft u de naam van de database waarvoor paginacompressie wordt ingeschakeld of uitgeschakeld.
rebuildNow	Facultatief. Hiermee geeft u op of database-indexen onmiddellijk opnieuw moeten worden opgebouwd (en indien nodig gecomprimeerd of gedecomprimeerd). Als deze niet worden gebruikt, worden indexen opnieuw opgebouwd door een achtergrondtaak die wekelijks wordt uitgevoerd.
offline	Facultatief. Alleen gebruikt in combinatie met /rebuildNow. Als /offline niet is opgegeven, worden indexen online opnieuw opgebouwd. Als /offline is opgegeven, worden indexen offline opnieuw opgebouwd. Dit blokkeert andere bewerkingen, maar kan sneller zijn dan het opnieuw opbouwen van een online index.

Vereiste voorwaarden

Als u de opdracht dbCompression wilt gebruiken, moet u lid zijn van de sysadmin-rol voor het opgegeven SQL Server-exemplaar.

Opmerkingen

Normaal gesproken gebruikt u de opdracht dbCompression als u een database verplaatst van een SQL-exemplaar dat compressie ondersteunde naar een database die dat niet deed. In dit geval moet u compressie uitschakelen en alle indexen decomprimeren voordat u de databases kunt verplaatsen. Als u een database terugzet naar een SQL-exemplaar dat compressie ondersteunt, wilt u mogelijk compressie opnieuw inschakelen om ruimte te besparen.

Met deze opdracht wordt alleen gewijzigd of Azure DevOps Server liever databasepaginacompressie gebruikt of niet. Uw databases moeten nog steeds worden gehost in een SQL-exemplaar waarvan de editie compressie ondersteunt. Zie Functies die worden ondersteund door de edities van SQL Server voor meer informatie.

Voorbeeld

In het volgende voorbeeld ziet u hoe u paginacompressie onmiddellijk inschakelt, waarbij indexen online opnieuw worden opgebouwd, voor een database met de naam TFS_DefaultCollection op een SQL-exemplaar dat wordt uitgevoerd op een server met de naam ContosoMain van het benoemde exemplaar TeamDatabases.

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

---

VerwijderTestResultaten

U gebruikt de opdracht deleteTestResults om oude opgeslagen testresultaten uit uw verzamelingsarchief te verwijderen. Dit wordt meestal gedaan om de winkelgrootte te verkleinen of om de tijd te verkorten die nodig is bij het migreren van testresultaten naar een nieuw schema.

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

Optie	Beschrijving
leeftijdInDagen	Testresultaten ouder dan het opgegeven aantal dagen worden verwijderd of voorvertoond.
sqlInstance	De naam van de server die als host fungeert voor de database waarvoor testresultaten worden verwijderd of een voorbeeld ervan worden bekeken, en de naam van het exemplaar als een ander exemplaar dan de standaardwaarde wordt gebruikt. Als u een exemplaar opgeeft, moet u de volgende indeling gebruiken: ServerName\InstanceName
databaseNaam	De naam van de database waarvoor testresultaten worden verwijderd of waarvan een voorbeeld wordt weergegeven.
soort	Facultatief. Het type testresultaten dat moet worden verwijderd. Geldige waarden zijn geautomatiseerd, handmatig en allemaal.
voorvertoning	Facultatief. Geef het aantal testresultaten weer dat wordt verwijderd op basis van de leeftijd in dagen, maar verwijder deze resultaten niet.

Vereiste voorwaarden

Als u de opdracht deleteTestResults wilt gebruiken, moet u lid zijn van de sysadmin-rol voor het opgegeven SQL Server-exemplaar.

Opmerkingen

Gebruik de parameter /preview om de testresultaten te bekijken die zijn gesorteerd op projectnaam en jaar zonder deze resultaten te verwijderen.

Voorbeeld

In het volgende voorbeeld ziet u hoe u handmatige testresultaten verwijdert die ouder zijn dan 60 dagen voor een database met de naam TFS_DefaultCollection op een SQL-exemplaar dat wordt uitgevoerd op een server met de naam ContosoMain van het benoemde exemplaar TeamDatabases.

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

---

DeploymentPool

De opdracht deploymentPool is ontworpen om alle implementatiegroepen van de ene implementatiegroep naar de andere te migreren.

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

Optie	Beschrijving
fromPool	Naam van brongroep.
toPool	Naam van bestemmingspool.

---

Identiteiten

Met de opdracht identiteiten worden de beveiligings-id (SID) van gebruikers en groepen in uw implementatie van Azure DevOps Server weergegeven of gewijzigd. Mogelijk moet u de SID voor gebruikers en groepen wijzigen of bijwerken in een van de volgende scenario's:

• Het domein van uw implementatie wijzigen

• Wijzigen van een werkgroep in een domein of van een domein in een werkgroep

• Accounts migreren tussen domeinen in Active Directory

Notitie

U hoeft deze opdracht niet uit te voeren als u domeinen in hetzelfde Active Directory-forest wijzigt. Azure DevOps Server verwerkt automatisch SID-wijzigingen voor verplaatsingen binnen hetzelfde forest.

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

Optie	Beschrijving
veranderen	Hiermee geeft u op dat u identiteiten wilt wijzigen in plaats van ze weer te geven.
fromdomain	Vereist bij gebruik van /change. Hiermee geeft u het oorspronkelijke domein van de identiteiten die u wilt wijzigen. Als u van een werkgroepomgeving verandert, geeft u de naam van de computer op.
todomain	Vereist bij gebruik van /change. Hiermee specificeert u het domein waarnaartoe u een identiteit wilt veranderen. Als u overschakelen naar een werkgroepomgeving, geeft u de naam van de computer op.
rekening	Hiermee geeft u de naam op van een account waarvoor u identiteiten wilt weergeven of wijzigen.
naar rekening	Hiermee geeft u de naam op van een account waarnaar u identiteiten wilt wijzigen.
SQLInstance	Hiermee geeft u de naam op van de server waarop SQL Server wordt uitgevoerd en de naam van het exemplaar als u een ander exemplaar dan het standaardexemplaar wilt gebruiken. Als je een exemplaar opgeeft, moet je het volgende formaat gebruiken: ServerName\InstanceName
DatabaseNaam	Hiermee geeft u de naam van de configuratiedatabase voor Azure DevOps Server.

Vereiste voorwaarden

Als u de opdracht identiteiten wilt gebruiken, moet u lid zijn van de beveiligingsgroep Team Foundation-beheerders en lid zijn van de rol sysadmin voor alle SQL Server-exemplaren die Team Foundation Server gebruikt. Zie Beheerdersmachtigingen instellen voor Azure DevOps Server voor meer informatie.

Opmerkingen

U kunt desgewenst de database opgeven om identiteiten te wijzigen voordat u een server in de toepassingslaag voor de implementatie configureert. U kunt bijvoorbeeld de database opgeven om het serviceaccount te wijzigen wanneer u een implementatie van Azure DevOps Server kloont.

Wanneer u identiteiten wijzigt, moeten het doelaccount of de doelaccounts al bestaan in Windows.

U moet wachten op de volgende identiteitssynchronisatie met Windows voordat de eigenschappen van accounts die u met deze opdracht wijzigt, worden bijgewerkt. Deze vereiste omvat wijzigingen van groep naar gebruiker, gebruiker naar groep en domeinaccount naar lokaal account.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de namen weergeeft van alle Windows-gebruikers en -groepen die zijn opgeslagen in Azure DevOps Server en om weer te geven of de SID voor elke gebruiker of groep overeenkomt met de SID in Windows. De Contoso1-domeinbeheerders hebben domeingroepen gemaakt, zoals Contoso1\\Developers en Contoso1\\Testers om het beheer van machtigingen in Azure DevOps Server, SQL Server Reporting Services en SharePoint-producten te vereenvoudigen.

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.

In het volgende voorbeeld ziet u hoe u de SID's voor alle accounts in Azure DevOps Server wijzigt van het Domein Contoso1 in de SID's voor accounts met overeenkomende namen in het ContosoPrime domein. Alleen accountnamen die overeenkomen, zullen hun SID's bijgewerkt worden. Als het hholt account bijvoorbeeld bestaat als Contoso1\hholt en ContosoPrime\hholt, wordt de account-SID gewijzigd in de SID voor ContosoPrime\hholt. Als het ContosoPrime\hholt account niet bestaat, wordt de SID niet bijgewerkt voor Contoso1\hholt.

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

In het volgende voorbeeld ziet u hoe u het account voor een enkel gebruikersaccount, Contoso1\hholt, wijzigt naar het account voor een ander gebruikersaccount, ContosoPrime\jpeoples.

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

In het volgende voorbeeld ziet u hoe u de SID van het NT AUTHORITY\NETWORK SERVICE serviceaccount wijzigt dat wordt gebruikt in de implementatie van Azure DevOps Server, wanneer u het domein van de implementatie van Contoso1 naar ContosoPrime verandert. Als u een systeemaccount zoals Network Service wilt wijzigen, moet u een proces met twee fasen volgen. U wijzigt eerst het serviceaccount van NT AUTHORITY\NETWORK SERVICE naar een domeinaccount in het nieuwe domein TempSVC, en vervolgens wijzigt u het account weer naar NETWORK SERVICE op de server in het nieuwe domein. De configuratiedatabase wordt gehost op de server met de naam ContosoMain van het benoemde exemplaar TeamDatabases 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"

---

Vacatures

U kunt de opdracht Taken gebruiken om een logboekbestand te maken dat de details bevat van de meest recente taakactiviteit voor een specifieke projectverzameling of om een taak opnieuw uit te voeren voor een of alle projectverzamelingen.

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

Optie	Beschrijving
Opnieuw	Vereist als /dumplog niet wordt gebruikt. Hiermee stelt u in dat de meest recente opdracht opnieuw zal worden geprobeerd voor de opgegeven projectverzameling. Als u deze optie gebruikt, moet u ook de optie /CollectionName of /CollectionID gebruiken.
dumplog	Vereist als /retry niet wordt gebruikt. Hiermee geeft u op dat de meest recente taakactiviteit voor de verzameling wordt verzonden naar een logboekbestand. Als u deze optie gebruikt, moet u ook de optie /CollectionName of /CollectionID gebruiken.
Collectienaam	Vereist als /CollectionID niet wordt gebruikt. Hiermee geeft u de naam van de verzameling waarvoor de meest recente taak opnieuw wordt geprobeerd (/opnieuw) of geregistreerd (/dumplog). Als u alle verzamelingen wilt opgeven, kunt u een sterretje (*) gebruiken.
CollectionID	Vereist als /CollectionName niet wordt gebruikt. Hiermee geeft u het identificatienummer op van de verzameling waarvoor de meest recente taak opnieuw wordt geprobeerd (/opnieuw proberen) of geregistreerd (/dumplog).

Vereiste voorwaarden

Als u de opdracht jobs wilt gebruiken, moet u lid zijn van de beveiligingsgroep Azure DevOps Administrators. Zie De machtigingsreferentie voor Azure DevOps Server voor meer informatie.

Opmerkingen

Als u een taak interactief opnieuw wilt proberen, kunt u de beheerconsole voor Azure DevOps openen, het tabblad Status voor de verzameling selecteren en vervolgens Taak opnieuw proberen selecteren. Zie De Azure DevOps-beheerconsole openen voor meer informatie.

Voorbeeld

In het volgende voorbeeld ziet u hoe u een logboekbestand maakt met de meest recente taakactiviteit voor de Contoso Summer Intern Projects projectverzameling in Azure DevOps Server.

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

---

Offline loskoppelen

U gebruikt de opdracht offlineDetach om een offlineverzamelingsdatabase te maken in een losgekoppelde offlineverzamelingsdatabase.

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

Optie	Beschrijving
configurationDB	Hiermee geeft u de naam op van de configuratiedatabase die moet worden gebruikt.
collectionDB	Hiermee geeft u de naam op van de verzamelingsdatabase die moet worden losgekoppeld.

Vereiste voorwaarden

De opdracht offlineDetach gebruiken:

• U moet lid zijn van de rol sysadmin voor het opgegeven SQL Server-exemplaar.
• De versie van het TFSConfig-hulpprogramma moet overeenkomen met de versie van de Azure DevOps Server-database.

Opmerkingen

Deze opdracht wijzigt het schema van de opgegeven verzamelingsdatabase en mag nooit worden uitgevoerd op databases die worden gebruikt door een Azure DevOps Server-implementatie. Als uw databases worden gebruikt door een Azure DevOps Server-implementatie, gebruik TfsConfig collection /detach in plaats daarvan.

Deze opdracht is handig wanneer u een afzonderlijke verzamelingsdatabase wilt herstellen vanuit een back-up zonder andere verzamelingsdatabases te herstellen die deel uitmaken van dezelfde Azure DevOps Server-implementatie. Voorheen moest een volledige en consistente set databases (configuratie en alle verzamelingen) worden hersteld naar een faseringsomgeving, een Azure DevOps Server-implementatie configureren met behulp van deze databases en de één verzameling van belang loskoppelen.

In plaats daarvan kunt u nu consistente kopieën van de configuratiedatabase en de verzamelingsdatabase herstellen en de offlineDetach-opdracht uitvoeren. De losgekoppelde verzamelingsdatabase kan vervolgens worden gekoppeld aan elke Azure DevOps Server-implementatie op een geschikte versie.

Voorbeeld

Het volgende voorbeeld illustreert het loskoppelen van een verzamelingsdatabase met de naam TFS_PrimaryCollection, met behulp van een configuratiedatabase met de naam TFS_Configuration, met beide op een SQL-exemplaar dat wordt uitgevoerd op een server met de naam ContosoTemp van het benoemde exemplaar Backups.

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

---

Tussenpersoon

U kunt de proxyopdracht gebruiken om de instellingen die door Azure DevOps Proxy Server worden gebruikt, bij te werken of te wijzigen. Azure DevOps Proxy Server biedt ondersteuning voor gedistribueerde teams voor het gebruik van versiebeheer door een cache met gedownloade versiebeheerbestanden te beheren op de locatie van het gedistribueerde team. Door Azure DevOps Proxy Server te configureren, kunt u de bandbreedte die nodig is voor wide area connections aanzienlijk verminderen. Daarnaast hoeft u het downloaden en opslaan in cache van versiebestanden niet te beheren; het beheer van de bestanden is transparant voor de ontwikkelaar die de bestanden gebruikt. Ondertussen worden metagegevensuitwisselingen en bestandsuploads nog steeds weergegeven in Azure DevOps Server. Als u Azure DevOps Services gebruikt om uw ontwikkelingsproject in de cloud te hosten, kunt u de proxyopdracht gebruiken om niet alleen de cache voor projecten in de gehoste verzameling te beheren, maar ook om enkele instellingen te beheren die door die service worden gebruikt.

Voor meer informatie over het installeren van Azure DevOps Proxy Server en de eerste configuratie van de proxy,

Zie Procedure: Azure DevOps Proxy Server installeren en een externe site instellen. Zie azure DevOps Version Control Command Reference voor meer informatie over het configureren van proxy op clientcomputers.

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

Optie	Beschrijving
toevoegen	Voegt de opgegeven server of verzameling toe aan de proxylijst in het Proxy.config-bestand. U kunt meerdere keren uitvoeren/toevoegen om meer verzamelingen of servers op te nemen. Wanneer u /add gebruikt met een verzameling die wordt gehost in Azure DevOps Services, wordt u gevraagd om uw referenties in Azure DevOps Services.
veranderen	Hiermee wijzigt u de referenties die als serviceaccount voor Azure DevOps Services zijn opgeslagen. De optie /change wordt alleen gebruikt voor Azure DevOps Services; deze mag niet worden gebruikt voor lokale implementaties van Azure DevOps Server.
verwijderen	Hiermee verwijdert u de opgegeven server of verzameling uit de proxylijst in het Proxy.config bestand.
rekening	Hiermee geeft u het account op dat wordt gebruikt als het serviceaccount voor de proxy in Azure DevOps Services. Deze optie wordt alleen gebruikt voor Azure DevOps Services in combinatie met de optie /change. Het standaardserviceaccount dat wordt gebruikt voor Azure DevOps Services is AccountService.
voortzetten	Hiermee wordt de uitvoering van de opdracht voortgezet, zelfs als het verificatieproces waarschuwingen produceert.
Verzameling	Hiermee geeft u de URL op van de projectverzameling die wordt gehost in Azure DevOps Services, in AccountName.DomainName/CollectionName indeling.
rekening	Hiermee geeft u de naam op van het account dat wordt gebruikt als het serviceaccount voor Azure DevOps Services. Als de accountnaam spaties bevat, moet de naam tussen aanhalingstekens ("") worden geplaatst. Alle speciale tekens in accountnamen moeten worden opgegeven in overeenstemming met de opdrachtregelsyntaxis.
rekening	Hiermee geeft u de URL van een Azure DevOps Server-implementatie, in ServerURL:Port/tfs indeling.
PersoonlijkToegangstokenBestand	U kunt desgewenst het pad naar een bestand opgeven dat een persoonlijk toegangstoken bevat. Dit token wordt gebruikt voor verificatie bij de verzameling of het account tijdens het registreren van een proxy. (Toegevoegd in TFS 2018 Update 1)
Ingangen	Facultatief. Hiermee geeft u aanvullende instellingen en waarden op die moeten worden gebruikt tijdens het configureren van de proxy.! Waarden voor GvfsProjectName en GvfsRepositoryName kunnen bijvoorbeeld worden gebruikt om een Git-opslagplaats te configureren voor gebruik met Git Virtual File System (GVFS) (toegevoegd in TFS 2018 Update 1)

Vereiste voorwaarden

Als u de proxyopdracht wilt gebruiken, moet u lid zijn van de beveiligingsgroep Azure DevOps Administrators en een beheerder op de proxyserver. Zie De machtigingsreferentie voor Azure DevOps Server voor meer informatie.

Opmerkingen

U gebruikt de proxyopdracht om de bestaande configuratie van De Azure DevOps Server-proxy bij te werken. U kunt de proxyopdracht niet gebruiken voor de eerste installatie en configuratie van de proxy.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een Azure DevOps Server-implementatie toevoegt met de naam FABRIKAM aan de proxylijst.

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

In het volgende voorbeeld ziet u hoe u een projectverzameling toevoegt die wordt gehost in Azure DevOps Services aan de proxylijst met behulp van een persoonlijk toegangstoken om te verifiëren. Dit token wordt alleen gebruikt om de proxy te registreren bij het Azure DevOps Services-account. Het standaardserviceaccount wordt nog steeds gebruikt om de proxy uit te voeren. Deze parameter is toegevoegd in TFS 2018 Update 1 ter ondersteuning van het registreren van een proxy bij Azure DevOps Services zonder dat u een aanmeldingsprompt nodig hebt.

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

In het volgende voorbeeld ziet u hoe u een projectverzameling toevoegt aan de proxylijst. In dit voorbeeld wordt een persoonlijk toegangstoken gebruikt om te verifiëren bij de verzameling die is opgegeven met de /Collection parameter. Het persoonlijke toegangstoken dat moet worden gebruikt, wordt opgeslagen in een bestand op c:\PersonalAccessToken.txt.

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

In het volgende voorbeeld ziet u hoe u het serviceaccount wijzigt dat wordt gebruikt door de proxy voor de projectverzameling die wordt gehost in Azure DevOps Services. De verzameling heeft de naam PhoneSaver, de accountnaam die wordt gebruikt voor Azure DevOps Services HelenaPetersen.fabrikam.comen het serviceaccount dat door de proxy wordt gebruikt, wordt gewijzigd in My Proxy Service Account. Omdat de accountnaam spaties bevat, worden aanhalingstekens gebruikt om de naam in te sluiten.

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

In het volgende voorbeeld ziet u hoe u een Git-opslagplaats toevoegt voor gebruik met GVFS.

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

---

RebuildWarehouse

U kunt de opdracht rebuildWarehouse gebruiken om de SQL Server Reporting Services- en SQL Server Analysis Services-databases die door Azure DevOps Server worden gebruikt, opnieuw te bouwen.

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

Optie	Beschrijving
analysisServices	Vereist als /all niet wordt gebruikt. Hiermee geeft u op dat alleen de database voor Analysis Services opnieuw wordt opgebouwd. Als er geen database bestaat voor Analysis Services, moet u ook de optie /reportingDataSourcePassword gebruiken.
alle	Vereist als /analysisServices niet wordt gebruikt. Hiermee geeft u op dat alle rapportage- en analysedatabases die door Azure DevOps Server worden gebruikt, opnieuw worden opgebouwd.
reportingDataSourceWachtwoord	Vereist als de TFS_Analysis-database niet bestaat. Hiermee geeft u het wachtwoord op van het account dat wordt gebruikt als het gegevensbronnenaccount voor SQL Server Reporting Services (TFSReports). Zie Serviceaccounts en afhankelijkheden in Azure DevOps Server voor meer informatie.

Vereiste voorwaarden

Als u de opdracht rebuildWarehouse wilt gebruiken, moet u lid zijn van de volgende groepen:

• De Azure DevOps Administrators-beveiligingsgroep en de beveiligingsgroep Administrators op de server of servers waarop de beheerconsole voor Azure DevOps wordt uitgevoerd

• De sysadmin-groep op de server of servers waarop het exemplaar van SQL Server wordt uitgevoerd dat als host fungeert voor de databases voor Azure DevOps Server

Zie De machtigingsreferentie voor Azure DevOps Server voor meer informatie.

Opmerkingen

U kunt deze opdracht gebruiken bij het verplaatsen of splitsen van een projectverzameling, het herstellen van gegevens of het anderszins wijzigen van de configuratie van uw implementatie.

Als u de herbouw van deze databases interactief wilt starten, kunt u het rapportageknooppunt in de beheerconsole voor Azure DevOps gebruiken. Zie De Azure DevOps-beheerconsole openen voor meer informatie.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de Analysis Services-database herbouwt voor een implementatie van 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

Gebruik registerDB om de naam bij te werken van de server die als host fungeert voor de configuratiedatabase in Azure DevOps Server. U kunt deze opdracht gebruiken bij het herstellen van de configuratiedatabase naar nieuwe hardware of bij het wijzigen van het domein van een implementatie.

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

Optie	Beschrijving
SQLInstance	Verplicht. Hiermee geeft u de naam op van de server waarop SQL Server wordt uitgevoerd en de naam van het exemplaar als u een ander exemplaar dan het standaardexemplaar wilt gebruiken. Als u een exemplaar opgeeft, moet u de volgende indeling gebruiken: ServerName\InstanceName
databaseNaam	Verplicht. Hiermee geeft u de naam van de configuratiedatabase. Dit is standaard Tfs_Configuration.

Vereiste voorwaarden

Als u de registerDB-opdracht wilt gebruiken, moet u lid zijn van de Azure DevOps-beheerdersgroep op de toepassingslaagserver voor Azure DevOps en lid zijn van de sysadmin-groep in SQL Server op de gegevenslaagserver voor Azure DevOps. Zie De machtigingsreferentie voor Azure DevOps Server voor meer informatie.

Opmerkingen

Maak een back-up van de databases voor Azure DevOps Server voordat u deze opdracht gebruikt.

Voor een geslaagde registerDB-opdracht moeten de volgende toepassingsgroepen en programma's worden uitgevoerd:

• Azure DevOps Server-toepassingsgroep (groep van toepassingen)
• ReportServer (groep van toepassingen)
• SQL Server Reporting Services (programma)

U moet de exacte naam of het exacte adres van de configuratiedatabase opgeven om deze opdracht correct te laten werken. Als u de server moet wijzigen waarop deze database is opgeslagen, moet u ervoor zorgen dat Azure DevOps Server naar de nieuwe locatie verwijst.

Voorbeeld

In het volgende voorbeeld wordt Azure DevOps Server omgeleid naar een configuratiedatabase die zich op de server ContosoMain in het SQL Server-exemplaar TeamDatabasesbevindt.

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

---

Opnieuw toewijzen van databases

Met de opdracht remapDBs wordt Azure DevOps Server omgeleid naar de databases wanneer deze zijn opgeslagen op meer dan één server en u de configuratie van uw implementatie herstelt, verplaatst of anderszins wijzigt. U moet bijvoorbeeld Azure DevOps Server doorverwijzen naar databases voor projectverzamelingen wanneer deze worden gehost op een andere server dan de configuratiedatabase. U moet Azure DevOps Server ook omleiden naar de server of servers waarop SQL Server Analysis Services of SQL Server Reporting Services wordt uitgevoerd als deze databases worden gehost op een afzonderlijke server of instantie van de configuratiedatabase.

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

Optie	Beschrijving
DatabaseNaam	Hiermee geeft u de naam op van de server die als host fungeert voor de database die u wilt toewijzen voor Azure DevOps Server, naast de naam van de database zelf.
SQLInstances	Hiermee geeft u de naam op van de server waarop SQL Server wordt uitgevoerd, samen met de naam van het exemplaar als u een ander exemplaar dan het standaardexemplaar wilt gebruiken. Als u meer dan één server opgeeft, moet u een komma gebruiken om meerdere paren server- en exemplaarnamen te scheiden.
AnalyseInstance	Facultatief. Hiermee geeft u de naam op van de server en het exemplaar dat als host fungeert voor SQL Server Analysis Services. Gebruik deze optie om de server en het exemplaar op te geven die als host fungeert voor de Analysis Services-database.
AnalyseDatabaseName	Facultatief. Hiermee geeft u de naam op van de Analysis Services-database die u wilt gebruiken met Azure DevOps Server als u meer dan één dergelijke database hebt op de server die u hebt opgegeven met de optie /AnalysisInstance .
voorvertoning	Facultatief. Geeft de acties weer die u moet uitvoeren om de configuratie bij te werken.
voortzetten	Facultatief. Hiermee geeft u op dat de Opdracht RemapDB moet doorgaan, zelfs als er een fout optreedt tijdens de poging om een of meer databases te vinden. Als u de optie /continue gebruikt, worden alle verzamelingen waarvan de databases niet zijn gevonden op de server of servers die u opgeeft, opnieuw geconfigureerd voor het gebruik van de server en het exemplaar dat als host fungeert voor de configuratiedatabase.

Vereiste voorwaarden

Als u de opdracht remapDBs wilt gebruiken, moet u lid zijn van de beveiligingsgroep Azure DevOps Administrators en lid zijn van de sysadmin-beveiligingsgroep voor sql Server-databases die door Azure DevOps Server worden gebruikt. Zie De machtigingsreferentie voor Azure DevOps Server voor meer informatie.

Opmerkingen

U gebruikt de opdracht remapDBs om Azure DevOps Server opnieuw te configureren voor het gebruik van verschillende servers en exemplaren van SQL Server vanaf de servers en exemplaren in de oorspronkelijke installatie.

Voorbeeld

In het volgende voorbeeld ziet u hoe u Azure DevOps Server omleidt naar de configuratiedatabase TFS_Configuration. Deze database wordt gehost op ContosoMain op de genoemde instantie TeamDatabases. De projectverzamelingsdatabases worden zowel op ContosoMain\TeamDatabases als op de standaardinstantie op Contoso2 opgeslagen.

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

---

RepairJobQueue

U gebruikt de opdracht repairJobQueue om geplande taken te herstellen die niet meer worden uitgevoerd voor implementatie- en verzamelingshosts.

TfsConfig repairJobQueue

Vereiste voorwaarden

Als u de opdracht repairJobQueue wilt gebruiken, moet u lid zijn van de lokale beheerdersgroep op de computer waarop TfsConfig wordt uitgevoerd. U moet ook lid zijn van de sysadmin beveiligingsrol voor alle SQL Server-exemplaren die door de implementatie van Azure DevOps Server worden gebruikt.

Opmerkingen

Normaal gesproken gebruikt u de opdracht repairJobQueue als u merkt dat geplande taken niet worden uitgevoerd.
De opdracht heeft geen argumenten en vereist dat de Azure DevOps Server-implementatie wordt geconfigureerd.

Voorbeeld

TfsConfig repairJobQueue

---

Instellingen

U kunt de opdracht Instellingen gebruiken om wijzigingen in de UNIFORM Resource Locator (URL) te automatiseren die wordt gebruikt door de meldingsinterface en voor het serveradres voor Azure DevOps Server. Standaard komen de URL van de meldingsinterface en de server-URL overeen in Azure DevOps Server, maar u kunt afzonderlijke URL's configureren. U kunt bijvoorbeeld een andere URL gebruiken voor de automatische e-mailberichten die door Azure DevOps Server worden gegenereerd. U moet dit hulpprogramma uitvoeren vanuit de toepassingslaag om alle servers bij te werken, zodat ze de nieuwe URL's gebruiken.

Als u deze URL's interactief wilt wijzigen of alleen de huidige instellingen wilt weergeven, kunt u de beheerconsole voor Azure DevOps gebruiken. Raadpleeg snelzoekgids voor beheertaken.

TfsConfig settings [/publicURL:URL]

Optie	Beschrijving
publieke URL	Hiermee geeft u de URL van de toepassingslaagserver voor Azure DevOps. Deze waarde wordt opgeslagen in de configuratiedatabase voor Azure DevOps.

Vereiste voorwaarden

U moet lid zijn van de beveiligingsgroep Azure DevOps Administrators en de groep Administrators op de server in de toepassingslaag. Zie Beheerdersmachtigingen instellen voor Azure DevOps Server voor meer informatie.

Opmerkingen

De opdracht Instellingen wijzigt de verbindingsgegevens voor server-naar-servercommunicatie in een implementatie van Azure DevOps Server. De URL die is opgegeven in /publicURL , moet beschikbaar zijn voor alle servers binnen de implementatie.

Voorbeeld

In het volgende voorbeeld wordt de waarde van NotificationURL gewijzigd in http://contoso.example.com/tfs en de waarde van ServerURL in http://contoso.example.com:8080/tfs.

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

---

Configuratie

U gebruikt de installatieopdracht om functies te verwijderen die momenteel zijn geconfigureerd op de computer waarop u de opdracht uitvoert.

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

Optie

Beschrijving

/uninstall

Hiermee geeft u een of meer functies die moeten worden verwijderd van de computer waarop u de opdracht uitvoert. Opties zijn: All, ApplicationTier, Search en VersionControlProxy.

Vereiste voorwaarden

Als u de installatieopdracht wilt gebruiken, moet u lid zijn van de beveiligingsgroep Azure DevOps Administrators.

Voorbeelden

In het volgende voorbeeld worden alle Azure DevOps Server-functies van de huidige computer verwijderd.

TfsConfig setup /uninstall:All

In het volgende voorbeeld worden de toepassingslaag en buildfuncties van de huidige computer verwijderd.

TfsConfig setup /uninstall:ApplicationTier 

---

TCM

Wanneer u een upgrade uitvoert naar de nieuwste versie van Azure DevOps Server, probeert het systeem automatisch de testbeheeronderdelen bij te werken, inclusief testplannen en -suites.

Als de automatische migratie mislukt, gebruikt u de TCM-opdracht om uw testplannen en testsuites handmatig te upgraden naar hun respectieve typen werkitems (WIT's).

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

Optie

Beschrijving

/upgradeTestPlans

Vereist tenzij /upgradeStatus wordt gebruikt.

Converteert bestaande testplannen en testsuites zodat ze verwijzen naar de testplannen en testsuites op basis van werkitems. Ook worden bestaande testbeheergegevens en koppelingen bijgewerkt tussen andere bestaande testartefacten, zoals testpunten, testuitvoeringen en testresultaten.

/upgradeStatus

Vereist tenzij /upgradeTestPlans wordt gebruikt.

Rapporteert de migratiestatus van testgegevens voor het opgegeven project. Ook wordt aangegeven of het opgegeven project testplannen heeft.

/CollectionName:CollectionName

Verplicht. Hiermee geeft u de projectverzameling op die het project bevat waarvoor u testgegevens wilt migreren of de migratiestatus wilt controleren.

Als er spaties in de naam van de projectverzameling staan, plaatst u de naam tussen aanhalingstekens, bijvoorbeeld 'Fabrikam Fiber Collection'.

/TeamProjectName:TeamProjectName

Verplicht. Hiermee geeft u het project op waarvoor u testgegevens wilt migreren of de migratiestatus wilt controleren. Dit project moet worden gedefinieerd in de verzameling die u hebt opgegeven met behulp van de parameter /collectionName .

Als er spaties in de naam van het project staan, plaatst u de naam tussen aanhalingstekens, bijvoorbeeld 'Mijn project'.

Vereiste voorwaarden

U moet lid zijn van de beveiligingsgroep Team Foundation Administrators en een beheerder op de toepassingslaagserver.

Zie Beheerdersmachtigingen instellen voor Azure DevOps Server.

Opmerkingen

Uw toepassingslaagserver moet worden bijgewerkt naar de nieuwste versie van Azure DevOps Server 2019 om deze opdracht te kunnen gebruiken.

Voordat u de TCM-opdracht kunt gebruiken, moet u eerst de definitie van het werkitem voor het testplan en de categorie testplan importeren in het project.

Zie Handmatige updates ter ondersteuning van testbeheer voor meer informatie over de migratie en wanneer u deze opdracht gebruikt.

De TCM-opdracht wordt toegepast op afzonderlijke projecten. Als u testplannen in meer dan één project moet upgraden, moet u het afzonderlijk uitvoeren voor elk project.

U moet de TCM-opdracht uitvoeren vanuit de map hulpprogramma's voor Azure DevOps Server. Deze locatie is standaard: drive:\%programfiles%\TFS 12.0\Tools.

U gebruikt de TCM-opdracht alleen in het geval dat automatische migratie van bestaande testgegevens mislukt.

Voor meer informatie over de migratie en wanneer u dit commando moet gebruiken, Handmatige updates ter ondersteuning van testbeheer. Als u geen toegang hebt tot testplannen of testsuites die zijn gedefinieerd vóór de serverupgrade, voert u TFSConfig TCM upgradeStatus uit om de status van de migratie te bepalen.

U voert de TCM-opdracht uit voor een afzonderlijk project. Als u meer dan één project moet upgraden, moet u het op zijn beurt uitvoeren op elk project.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de status van de upgrade van het testplan kunt controleren op het Fabrikam Fiber-project dat wordt gehost op de standaardprojectverzameling (DefaultCollection):

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

---

Zonder toezicht

Beschikbaarheid van opdrachten: Azure DevOps Server 2019

De opdracht zonder toezicht is ontworpen voor gebruikers die bekend zijn met Azure DevOps Server en het configuratieproces en die Azure DevOps Server op verschillende computers moeten installeren.

Als u bijvoorbeeld Azure DevOps Build gebruikt, kunt u de opdracht zonder toezicht gebruiken om meerdere buildservers te installeren met hetzelfde configuratiebestand.

Gebruik de optie /create om een bestand zonder toezicht te maken. Dit bestand definieert alle configuratieparameters voor een Azure DevOps Server-installatie. Gebruik vervolgens de optie /configure om de configuratie daadwerkelijk uit te voeren.

Met dit proces kunt u Azure DevOps Server van begin tot eind configureren zonder dat u tijdens het installatieproces invoer hoeft op te geven. In het geval van meerdere installaties zorgt dit er ook voor dat dezelfde configuratieparameters op meerdere servers worden gebruikt.

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

Optie	Beschrijving
maken	Hiermee maakt u het bestand zonder toezicht met de naam en parameters die u opgeeft.
configureren	Hiermee configureert u Azure DevOps Server met het unattend-bestand en de door u opgegeven parameters. U moet /type of /unattendfile gebruiken met deze optie.
soort	Hiermee geeft u het type configuratie dat moet worden gebruikt. Wanneer u /configure gebruikt, zijn /type of /unattendfile vereist, maar u kunt beide niet gebruiken.
unattendfile	Afhankelijk van of de eerste parameter /create of /configure is, specificeer het unattend-bestand om te maken of te gebruiken. Wanneer u /configure gebruikt, is /unattendfile of /type vereist.
Ingangen	Facultatief. Als u /create gebruikt, geeft u instellingen en waarden op die moeten worden gebruikt bij het maken van het bestand zonder toezicht. Als u /configure specificeert, geeft dit extra instellingen en waarden aan die samen met het bestand zonder toezicht moeten worden gebruikt. Als alternatief voor het gebruik van /inputs kunt u het bestand zonder toezicht handmatig bewerken in een editor voor tekst zonder opmaak. Dit is nodig voor bepaalde invoertypen, zoals ServiceAccountPassword of PersonalAccessToken, omdat deze geheime waarden niet kunnen worden ingesteld met behulp van de parameter /input.
verifiëren	Facultatief. Stelt een configuratieuitvoering vast die alleen verificatiecontroles voltooit op basis van het unattend-bestand, de invoer en het configuratietype. Dit is een alternatief voor het uitvoeren van een volledige configuratie.
voortzetten	Facultatief. Hiermee geeft u op dat /create of /configure moet doorgaan, ongeacht waarschuwingen van verificatiecontroles.

Installatietype	Beschrijving
NewServerBasic	Hiermee configureert u de essentiële ontwikkelservices voor Azure DevOps Server. Dit omvat broncodebeheer, werkitems, bouwen en optioneel zoeken.
NewServerAdvanced	Configureert de essentiële ontwikkelingsservices en maakt optionele configuratie van integratie met Reporting Services mogelijk.
Opwaarderen	Hiermee wordt Azure DevOps Server bijgewerkt naar de huidige versie van een ondersteunde vorige versie.
PreProductionUpgrade	Test de upgrade op een bestaande Azure DevOps Server-implementatie in een preproductieomgeving. Dit wordt meestal gedaan met behulp van databases die zijn hersteld vanuit productieback-ups. Dit scenario bevat aanvullende stappen om ervoor te zorgen dat de nieuwe implementatie geen invloed heeft op de productie-implementatie.
ApplicationTierOnlyBasic	Configureer een nieuwe toepassingslaag met behulp van bestaande instellingen uit de opgegeven configuratiedatabase. Met deze optie kunt u snel aan de slag met een nieuwe toepassingslaag met behulp van bestaande instellingen. Als u de mogelijkheid wilt om bestaande instellingen te wijzigen, gebruikt u in plaats daarvan het type Advanced ApplicationTierOnlyAdvanced.
ToepassingslaagAlleenGeavanceerd	Configureer een nieuwe toepassingslaag met volledige controle over alle instellingen. Instellingen worden standaard ingesteld op bestaande waarden uit de opgegeven configuratiedatabase. Als u al uw bestaande instellingen wilt behouden, gebruikt u in plaats daarvan het type ApplicationTierOnlyBasic.
Kloon	Configureer een nieuwe Azure DevOps Server-implementatie. Dit is een kloon van een bestaande implementatie. Dit gebeurt meestal met behulp van databases die zijn hersteld vanuit productieback-ups, om een omgeving te maken waarin configuratiewijzigingen, extensies en andere wijzigingen kunnen worden getest. Dit scenario bevat aanvullende stappen om ervoor te zorgen dat de nieuwe implementatie geen invloed heeft op de productie-implementatie.
Tussenpersoon	Hiermee configureert u een proxyservice voor versiebeheer.

Vereiste voorwaarden

• U moet lid zijn van de groep Administrators op de computer waarop u de software installeert.

• Afhankelijk van het type installatie hebt u mogelijk ook aanvullende beheerdersmachtigingen nodig.

Als u bijvoorbeeld de opdracht zonder toezicht gebruikt om Azure DevOps Server te installeren, moet u lid zijn van de sysadmin-groep op het exemplaar van SQL Server dat Ondersteuning biedt voor Azure DevOps Server. Zie de sectie Q & A van Beheerders op serverniveau toevoegen aan Azure DevOps Server voor meer informatie.

Opmerkingen

Voordat u de opdracht zonder toezicht kunt gebruiken om Azure DevOps Server te configureren, moet u de serviceaccounts maken die u als onderdeel van uw implementatie gaat gebruiken. U moet ook vereiste software installeren voor het gekozen installatietype. Dit omvat Azure DevOps Server zelf. U moet Azure DevOps Server installeren, maar u hoeft deze niet te configureren omdat de opdracht zonder toezicht dat voor u doet.

Met de opdracht zonder toezicht configureert u Azure DevOps Server-onderdelen. De eerste installatie van de software wordt niet uitgevoerd. De software wordt geconfigureerd op basis van uw specificaties nadat de bits aanwezig zijn op de computer.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een bestand zonder toezicht maakt voor een eenvoudige installatie van Azure DevOps Server.

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

In dit voorbeeld wordt het bestand zonder toezicht gemaakt in dezelfde map als de opdracht. Er wordt een logboekbestand gemaakt als onderdeel van de opdracht en de locatie van het bestand wordt geretourneerd in de opdracht als onderdeel van het uitvoeren van de opdracht.

In het volgende voorbeeld ziet u hoe u een Git-opslagplaats opgeeft voor gebruik met GVFS tijdens de configuratie.

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

In het volgende voorbeeld ziet u hoe u een bestand zonder toezicht maakt voor de configuratie van een Azure DevOps-proxyserver.

Belangrijk

Als de beheerders in dit voorbeeld een persoonlijk toegangstoken willen gebruiken voor verificatie, moeten ze het bestand handmatig bewerken om de waarde van het persoonlijke toegangstoken op te geven. Dit kan worden bereikt door een regel toe te voegen voor het persoonlijke toegangstoken in het gemaakte bestand zonder toezicht, zoals: PersonalAccessToken=PersonalAccessTokenValue.

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

In het volgende voorbeeld ziet u hoe u een bestand zonder toezicht maakt voor de configuratie van Azure DevOps Server Build op een server met behulp van FabrikamFiber\BuildSVC het buildserviceaccount en vervolgens Azure DevOps Server Build configureert met behulp van dat bestand zonder toezicht.

Belangrijk

In dit voorbeeld, nadat het bestand zonder toezicht is gemaakt, bewerkt de beheerder het bestand handmatig om het wachtwoord voor het buildserviceaccount op te geven. Als u het wachtwoord toevoegt als invoer, ServiceAccountPassword=PasswordPlaceholder; worden de wachtwoordgegevens niet aan het bestand toegevoegd.

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

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

De eerste opdracht retourneert het volgende:

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

De tweede opdracht retourneert de volgende informatie, inclusief de naam van de server waarop Azure DevOps Build is geconfigureerd FabrikamFiberTFS en de projectverzameling die is gekoppeld aan de 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

De ziplogs-opdracht is ontworpen om logboeken te verzamelen en een zip bij ProgramData\Microsoft\Azure DevOps\Server Configurationte laten vallen.

TfsConfig zipLogs

TfsConfig zipLogs

---