Verwenden von TFSConfig zum lokalen Verwalten von Azure DevOps

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

Sie können das Befehlszeilentool TFSConfig verwenden, um eine Vielzahl von Verwaltungsaktionen für Ihre lokale Azure DevOps-Bereitstellung auszuführen.

TFSConfig kann auf jedem Computer ausgeführt werden, auf dem Azure DevOps Server installiert wurde.

Speicherort des Befehlszeilentools

Azure DevOps-Befehlszeilentools werden im Verzeichnis /Tools eines Azure DevOps-Anwendungsebenenservers installiert.

• 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

Voraussetzungen

Damit viele Befehle ordnungsgemäß ausgeführt werden können, muss TFSConfig in der Lage sein, eine Verbindung mit den verschiedenen Servern und Diensten herzustellen, die Teil Ihrer TFS-Bereitstellung sind, und der Benutzer, der TFSConfig ausführt, muss über Administratorberechtigungen für dieselben Server und Dienste verfügen. Die Anforderungen für bestimmte Befehle werden unten aufgeführt.

Viele TFSConfig-Befehle müssen über eine Eingabeaufforderung mit erhöhten Rechten ausgeführt werden, auch wenn der ausgeführte Benutzer über Administratoranmeldeinformationen verfügt. Klicken Sie zum Öffnen einer Eingabeaufforderung mit erhöhten Rechten auf Start, mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. Weitere Informationen finden Sie unter Benutzerkontensteuerung.

Sie können verwaltungstechnische Aktionen auch interaktiv über die Verwaltungskonsole für Azure DevOps Server ausführen. Weitere Informationen finden Sie unter Kurzübersicht zu administrativen Aufgaben.

Auflisten von Befehlen und Hilfe

Verwenden Sie den Befehl help, um eine vollständige Liste der TFSConfig-Befehle anzuzeigen:

TFSConfig help

Um Hilfe für einen einzelnen Befehl zu erhalten, verwenden Sie den Befehl help , und geben Sie den Namen des Befehls an, für den Sie Hilfe benötigen. So erhalten Sie beispielsweise Hilfe für den Kontobefehl:

TFSConfig help accounts

Konten

Verwenden Sie den Befehl konten, um diese Azure DevOps Server-Dienstkonten zu verwalten.

• das Azure DevOps Server-Dienstkonto
• das Datenquellenkonto für SQL Server Reporting Services
• Das Azure DevOps Proxy Server-Dienstkonto

Sie können diesen Befehl auch verwenden, um den Besitz der Azure DevOps Server Datenbanken zu ändern.

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

Vorgang	BESCHREIBUNG
UpdatePassword	Ändert das Kennwort eines Kontos, das als Dienstkonto verwendet wird. Ändert das vorhandene Konto und alle accountTypes, die als das angegebene Konto ausgeführt werden.
Change	Ändert das Konto, das als Dienstkonto verwendet wird. Fügt das neue Konto den erforderlichen Ressourcen und Gruppen hinzu, gewährt die erforderlichen Berechtigungen und legt dann den Dienst für die Verwendung fest. Dadurch wird das alte Konto nicht aus den Ressourcen entfernt. Wenn Sie die Option accountType nicht verwenden, wird das Dienstkonto für die Anwendungsebene geändert.
Hinzufügen	Fügt das neue Konto nur den erforderlichen Ressourcen hinzu. Nützlich für NLB-Szenarien. Verwenden Sie das Continue-Flag, wenn einige Sammlungen nicht erreichbar sind. Add kann später erneut ausgeführt werden, um fehlende Sammlungen zu aktualisieren. Fügt den Gruppen, die zum Verwenden des Kontos als Dienstkonto erforderlich sind, ein Konto hinzu.
Set	Legt nur fest, dass der Dienst ein Konto verwendet, das den Ressourcen bereits hinzugefügt wurde. Nützlich für NLB-Szenarien.
Löschen	Entfernt das Konto aus allen Ressourcen. Beim Löschen eines Kontos sollten Vorsichtsmaßnahmen getroffen werden, da dies dazu führen kann, dass der Dienst für andere Server verweigert wird.
ResetOwner	Wenn die Datenbanken im Rahmen einer Verschiebung, eines Klons oder einer Notfallwiederherstellung wiederhergestellt werden, kann der Datenbankbesitzer zum Administrator wechseln, der den Server wiederherstellen soll. Diese Option durchläuft alle Datenbanken und legt die dbo-Anmeldung auf den aktuellen Besitzer fest.

AccountType	BESCHREIBUNG
AdminConsole	Verwaltungskonsole Benutzer sind Benutzer, denen die Mindestberechtigungen für verschiedene Ressourcen für die Verwendung der Konsole erteilt wurden.
ApplicationTier	Ändert das Dienstkonto im appPool für die Kernwebdienste. (TFSService)
Proxy	Ändert das Dienstkonto im appPool für die Proxywebdienste. (TFSProxy)
ReportingDataSource	Ändert das Konto, das die Berichte für den Zugriff auf die Berichtsdaten verwenden. (TFSReports)

Der Standardwert ist ApplicationTier.

SqlInstance und databaseName eignen sich nur für die Verwendung beim Hinzufügen eines Kontos zu Datenbanken, bevor die Anwendungsebene konfiguriert wird. Dies ist in erster Linie in Notfallwiederherstellungsszenarien nützlich, in denen ein anderes Konto erforderlich ist, bevor der Konfigurations-Assistent für nur AT ausgeführt wird.

Die Option continue wird beim Hinzufügen oder Ändern eines Kontos verwendet. Für diese Vorgänge wird das Konto in jeder Sammlungsdatenbank geändert. Wenn continue angegeben wird, wird sie fortgesetzt, wenn eine Sammlung nicht erreichbar ist. Sie kann erneut ausgeführt werden, wenn sie erreichbar sind.

Hinweis

Die Konten müssen im Format domainName\userName vorliegen. Für Systemkonten müssen Sie Anführungszeichen um den vollständigen Kontonamen (z. B. "NT-Autorität\Netzwerkdienst") verwenden. Systemkonten erfordern kein Kennwort.

Parameter	BESCHREIBUNG
Konto	Gibt den Namen des Kontos an, das Sie einem Kontotyp hinzufügen, ändern oder löschen möchten, auf den verwiesen wird, z. B. /AccountType:ApplicationTier.
Kennwort	Gibt das Kennwort für das Dienstkonto an. Dieser Parameter ist optional, wenn Sie ein Systemkonto oder ein Konto verwenden, das kein Kennwort besitzt, z. B. Netzwerkdienst.
sqlInstance	Wird nur mit /ResetOwner verwendet. Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, und den Namen der instance, wenn Sie eine andere instance als die Standard-instance verwenden möchten. Sie müssen den Namen und die Instanz im folgenden Format angeben: ServerName\Instanzname.
databaseName	Wird nur mit /ResetOwner verwendet. Gibt den Namen der Datenbank an, deren Besitz geändert werden soll. Mit diesem Befehl haben Sie den Besitz an der Datenbank zurückgesetzt, die Sie dem Konto zuordnen, unter dem der Befehl ausführt wird.
continue	Aktualisiert alle Gruppen, die nicht verfügbar sind, wenn Sie den Befehl ausführen. Diese Option wird normalerweise in NLB-Szenarien verwendet.

Voraussetzungen

Um den Befehl "accounts " verwenden zu können, müssen Sie Mitglied von sein:

• Die Sicherheitsgruppe "Azure DevOps-Administratoren"
• die Sysadmin-Rolle für alle SQL Server Instanzen, die Ihr Azure DevOps Server instance verwendet.

Wenn Sie die Option /proxy verwenden, müssen Sie Administrator auf dem Proxyserver sein.

Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

Verwenden Sie den Befehl konten, um Änderungen an den Dienstkonten, Datenbanken und Dienstkontogruppen von Azure DevOps Server zu automatisieren. Sie können Konten konfigurieren, die Sie bereits erstellt haben, aber sie können keine Konten erstellen.

Bevor Sie die Domäne oder Arbeitsgruppe eines Kontos ändern, muss das Konto über die Berechtigung "Konto ist vertraulich" verfügen und kann nicht auf dem Anwendungsebenenserver delegiert werden. Weitere Informationen finden Sie auf dieser Seite auf der Microsoft-Website: Aktivieren der delegierten Authentifizierung.

Der Befehl accounts unterstützt lokale Azure DevOps Server Bereitstellungen. Informationen zum Ändern des Kontobesitzers eines Azure DevOps Services Kontos finden Sie unter Ändern des Kontobesitzes.

Beispiele

Ändern Sie das Dienstkonto der Datenquellen für Reporting Services in ein neues Konto in der Contoso-Domäne und Contoso\NewAccountdas Kennwort in Password.

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

Fügen Sie das Netzwerkdienstsystemkonto den Dienstkontogruppen für Azure DevOps Server hinzu (Systemkonten haben keine Kennwörter).

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

Ändern Sie den Besitz der TFS_Warehouse Datenbank auf dem ContosoMain SQL Server im TeamDatabases benannten instance in das Benutzerkonto, unter dem Sie den Befehl ausführen.

Hinweis

Sie können nicht angeben, welches Konto als Besitzer der Datenbanken festgelegt werden soll, wenn Sie diesen Befehl verwenden. Der Besitzer wird auf das Konto festgelegt, unter dem Sie den Befehl ausführen.

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

---

AddProjectReports

Hinweis

Der Befehl addProjectReports ist mit TFS 2017.1 und höheren Versionen verfügbar.

Sie verwenden den Befehl addProjectReports , um Berichte für ein vorhandenes Teamprojekt hinzuzufügen oder zu überschreiben.

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

Option	BESCHREIBUNG
collection	Erforderlich. URL der Teamprojektsammlung.
teamprojekt	Erforderlich. Gibt den Namen des Teamprojekts an.
Vorlage	Erforderlich. Gibt den Namen der Prozessvorlage an. Verfügbare Optionen sind Agile, CMMI und Scrum.
force	Optional. Gibt an, dass Berichte überschrieben werden sollen, wenn sie bereits vorhanden sind.

Voraussetzungen

Um den Befehl addProjectReports verwenden zu können, benötigen Sie berechtigungen zum Ausführen von TFSConfig und zum Hochladen von Berichten in den Reporting Service.

Hinweise

Sie verwenden den Befehl addProjectReports , wenn Ihr Projekt keine Berichte enthält oder wenn Sie die für einen Prozess definierten Berichte aktualisieren möchten.

Möglicherweise müssen Sie diesen Befehl in folgenden Fällen verwenden:

• Das Projekt wurde im Azure DevOps-Portal und nicht in Visual Studio erstellt.
• Das Projekt wurde in Visual Studio erstellt, die Berichterstellung wurde jedoch nicht in Azure DevOps Server konfiguriert.

Wenn Sie Berichte in Ihrem Projekt mit Standardberichten überschreiben möchten, weil Sie Azure DevOps Server aktualisiert haben und alte Berichte in Ihrem Projekt nicht mehr kompatibel sind, verwenden Sie die Option /force. Wenn Sie angepasste Berichte haben, erstellen Sie eine Sicherung, bevor Sie dies tun.

Weitere Informationen zum Hinzufügen von Berichten zu einem lokalen Azure DevOps Server finden Sie unter Hinzufügen von Berichten zu einem Projekt.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Agile-Berichte dem MyProject Projekt in der http://myTfsServer:8080/tfs/DefaultCollection Projektsammlung hinzugefügt werden.

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

---

Authentifizierung

Der Authentifizierungsbefehl ändert das Netzwerkauthentifizierungsprotokoll, das von der Azure DevOps Server Anwendungsebene oder Proxywebsite verwendet wird.

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

Option

Beschreibung

/viewAll

Zeigt die aktuellen Authentifizierungseinstellungen für Azure DevOps Server an.

/provider: { NTLM | Negotiate }

Gibt den Authentifizierungsanbieter an, den Sie für die Website konfigurieren möchten.

• NTLM: Verwenden des NTML-Authentifizierungsprotokolls
• Negotiate: Verwenden des Negotiate-Authentifizierungsprotokolls (Kerberos)

/siteType

Gibt die Website (Anwendungsebene oder Proxy) an, deren Netzwerkauthentifizierungsprotokoll Sie ändern möchten. Die Anwendungsebene ist die Standardeinstellung.

Voraussetzungen

Um den Authentifizierungsbefehl verwenden zu können, müssen Sie mitglied der Sicherheitsgruppe Azure DevOps-Administratoren und ein lokaler Administrator auf dem Anwendungsserver oder Proxyserver sein, je nach Wert der SiteType-Option .

Hinweise

Der Authentifizierungsbefehl wird von einem Administrator verwendet, der das Netzwerkauthentifizierungsprotokoll für eine oder mehrere Websites ändern möchte, auf denen Azure DevOps Server basiert. Der Administrator führt diesen Befehl auf der Anwendungsebene aus, um die Websites zu aktualisieren, deren Netzwerkauthentifizierungsprotokoll geändert werden muss. Der Befehl ändert die NTAuthenticationProviders-Eigenschaft in der IIS-Metabasis.

Bevor Sie den Authentifizierungsbefehl zum Ändern des Authentifizierungsprotokolls verwenden, können Sie den Befehl mit der Option /viewAll ausführen, um die vorhandenen Einstellungen anzuzeigen.

Beispiel

Im folgenden Beispiel wird der aktuelle Wert angezeigt, der für das Netzwerkauthentifizierungsprotokoll zugewiesen ist.

TFSConfig Authentication /viewAll

---

Zertifikate

Verwenden Sie den Befehl zertifikate, um zu ändern, wie Zertifikate für die Clientauthentifizierung in einer Bereitstellung von Azure DevOps Server konfiguriert werden, die HTTPS, SSL (Secure Sockets Layer) und Zertifikate verwendet.

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

Option	BESCHREIBUNG
Computer	Gibt an, dass die Zertifikatliste nicht aus dem aktuellen Benutzerkontext, sondern aus dem Kontext des lokalen Computers stammt.
disable	Gibt an, dass die Clientauthentifizierungszertifikateinstellung deaktiviert wird.
autoSelect	Gibt an, dass ein Zertifikat automatisch aus der Zertifikatliste ausgewählt wird. Das Fenster Clientzertifikate verwalten wird nicht geöffnet.
noprompt	Gibt an, dass das Fenster Clientzertifikate verwalten nicht geöffnet wird, wenn der Befehl Zertifikate ausgeführt wird.
Fingerabdrücke	Gibt an, dass das Zertifikat verwendet wird, das dem angegebenen Fingerabdruck entspricht. Sie können mehrere Zertifikate angeben, indem Sie einzelne Fingerabdruck durch ein Komma trennen.

Voraussetzungen

Um den Zertifikatbefehl verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren und der lokalen Administratorgruppe auf dem Computer sein, auf dem Sie den Befehl ausführen. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

Standardmäßig wählt der Zertifikatbefehl automatisch ein Clientzertifikat aus der Zertifikatliste für den aktuellen Benutzer aus. Sie können jedoch die Optionen für den Befehl verwenden, um ein bestimmtes Zertifikat oder Zertifikate aus dem aktuellen Benutzerkontext oder aus dem kontext des lokalen Computers anzugeben.

Bevor Sie den Befehl zertifikate verwenden, müssen Sie zunächst die Server in Ihrer Bereitstellung von Azure DevOps Server konfigurieren, um Zertifikate zu verwenden. Weitere Informationen finden Sie unter Einrichten von HTTPS mit Secure Sockets Layer (SSL) für Azure DevOps Server.

Sie verwenden den Befehl zertifikate, um die Clientzertifikate zu konfigurieren, die von einer Bereitstellung von Azure DevOps Server verwendet werden, die für die Verwendung von HTTPS/SSL und Zertifikaten konfiguriert wurde. Wenn Sie den Befehl Zertifikate ohne Optionen verwenden, wird automatisch ein Clientzertifikat aus dem aktuellen Benutzerkontext ausgewählt, in dem Sie den Befehl ausführen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie das Zertifikat des lokalen Computers ohne Aufforderung mit dem Fingerabdruck aa bb cc dd ee angegeben wird.

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

Im folgenden Beispiel wird gezeigt, wie mithilfe der automatischen Auswahl eines Clientzertifikats aus dem aktuellen Benutzerspeicher angegeben wird.

TfsConfig certificates /autoselect

---

ChangeServerID

Mit dem Befehl changeServerID werden die GUIDs geändert, die den Datenbanken für Azure DevOps Server zugeordnet sind. GUIDs müssen innerhalb einer Bereitstellung von Azure DevOps Server eindeutig sein. Wenn mehr als eine Datenbank über dieselbe GUID verfügt, kann Ihre Bereitstellung instabil oder unbrauchbar werden. Sie können die GUID für die Konfigurationsdatenbank, die GUIDs für alle Projektsammlungsdatenbanken in der Bereitstellung oder beides ändern.

Obwohl Sie diesen Befehl in der Regel nicht in täglichen Vorgängen verwenden würden, können Sie diesen Befehl unter den folgenden Umständen verwenden:

• Sie haben Ihre Bereitstellung auf neuer Hardware wiederhergestellt, die alte Bereitstellung ist weiterhin betriebsbereit, und Sie möchten beide Bereitstellungen verwenden. Dieses Szenario wird manchmal als Klonen des Servers bezeichnet.

• Sie möchten ein Softwareupdate oder eine Hardwarekonfiguration in einer doppelten Bereitstellung testen, damit Sie keine Unterbrechungen Ihrer Produktionsumgebung riskieren.

• Sie möchten die Wiederherstellung von Datenbanken auf neuer Hardware in einer Testumgebung oder einer separaten Umgebung vollständig testen, um sicherzustellen, dass Ihre Bereitstellung wiederhergestellt werden kann.

• Sie müssen die GUID für eine Sammlungsdatenbank zurücksetzen, nachdem Sie sie in eine andere Bereitstellung verschoben haben, für die diese GUID bereits reserviert ist.

Hinweis

Der Befehl changeServerID kann nicht rückgängig gemacht werden. Nachdem eine GUID geändert wurde, können Sie diese Änderung nur rückgängigmachen, wenn Sie eine frühere Version dieser Datenbank wiederherstellen.

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

Option	BESCHREIBUNG
sqlInstance	Erforderlich. Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, und den Namen der instance, wenn Sie eine andere instance als die Standard-instance verwenden möchten. Wenn Sie eine instance angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
databaseName	Erforderlich. Gibt den Namen der Konfigurationsdatenbank für Azure DevOps Server an. Standardmäßig lautet der Name dieser Datenbank TFS_ConfigurationDB.
projectCollectionsOnly	Gibt an, dass nur die GUIDs für Sammlungen geändert werden.
configDBOnly	Gibt an, dass nur die GUID für die Konfigurationsdatenbank geändert wird.
collectionName	Gibt an, dass eine neue instance-ID für die bestimmte Sammlung, aber nicht für Azure DevOps-instance und die anderen Sammlungen erstellt werden soll.

Voraussetzungen

Um den Befehl changeServerID verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren und Mitglied der Sicherheitsrolle sysadmin für alle SQL Server Instanzen sein, die Azure DevOps Server verwendet. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps.

Hinweise

Sie verwenden den Befehl changeServerID, um ein diskretes Duplikat einer Bereitstellung von Azure DevOps Server zu Test- oder Klonzwecken zu erstellen. Nachdem Sie den Befehl changeServerID verwendet haben, müssen Sie Clients anweisen, eine Verbindung mit dem geänderten Server herzustellen, bevor er verwendet werden kann.

Beispiel

Das folgende Beispiel zeigt, wie die GUIDs aller Datenbanken in der Contoso1-Bereitstellung von Azure DevOps Server geändert werden, wobei die Konfigurationsdatenbank auf dem Server gehostet wird, der auf dem benannten instance TeamDatabases in SQL Server benannt ContosoMain ist.

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

---

CodeIndex

Verwenden Sie den CodeIndex-Befehl, um die Codeindizierung für Azure DevOps Server zu verwalten. Beispielsweise können Sie den Index zurücksetzen, um CodeLens-Informationen zu korrigieren, oder die Indizierung deaktivieren, um Probleme mit der Serverleistung zu untersuchen.

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

Option	BESCHREIBUNG
indexingStatus	Zeigen Sie den Status und die Konfiguration des Codeindexdiensts an.
setIndexing	on: Indizierung aller Changesets beginnen. off: Indizierung aller Changesets beenden. keepupOnly: Indizierung zuvor erstellter Changesets beenden und mit der Indizierung nur der neuen Changesets beginnen.
ignoreList	Gibt eine Liste mit Codedateien und ihren Pfaden an, die nicht indiziert werden sollen. add: Die Datei, die Sie nicht indizieren möchten, zur Liste der ignorierten Dateien hinzufügen. remove: Die Datei, die Sie indizieren möchten, aus der Liste der ignorierten Dateien entfernen. removeAll: Die Liste der ignorierten Dateien wird geleert und die Indizierung aller Dateien begonnen. view: Alle Dateien anzeigen, die nicht indiziert werden. ServerPath: Gibt den Pfad zu einer Codedatei an. Sie können das Platzhalterzeichen (*) am Anfang, am Ende oder an beiden Enden des Serverpfads verwenden.
listLargeFiles	Zeigt die angegebene Anzahl der Dateien an, die die angegebene Größe in KB überschreitet. Sie können dann mithilfe der Option /ignoreList diese Dateien von der Indizierung ausschließen. Dazu benötigen Sie Team Foundation Server 2013 mit Update 3.
ReindexAll	Zuvor indizierte Daten werden gelöscht, und die Indizierung wird neu gestartet.
destroyCodeIndex	Der Codeindex wird gelöscht, und alle indizierten Daten werden entfernt. Erfordert keine Bestätigung, wenn Sie die Option /noPrompt verwenden.
temporaryDataSizeLimit	Steuern Sie, wie viele temporäre Daten CodeLens bei der Verarbeitung von Changesets erstellt. Die Standardgrenze ist 6 GB (2 GB in Update 5). view: Die aktuelle Größenbeschränkung anzeigen. SizeInGBs: Ändern Sie die Größenbeschränkung. disable: Die Größenbeschränkung entfernen. Diese Grenze wird überprüft, bevor CodeLens ein neues Changeset verarbeitet. Wenn die temporären Daten diese Grenze überschreiten, hält CodeLens die Verarbeitung vergangener und nicht neuer Changesets an. CodeLens beginnt wieder mit der Verarbeitung, nachdem die Daten bereinigt wurden und unter diese Grenze fallen. Die Bereinigung wird automatisch einmal pro Tag ausgeführt. Das bedeutet, dass temporäre Daten diese Grenze möglicherweise überschreiten, bis die Bereinigung ausgeführt wird. Dazu benötigen Sie Team Foundation Server 2013 mit Update 4.
indexHistoryPeriod	Steuern, wie lange der Änderungsverlauf indiziert werden soll. Dies beeinflusst, wie viel Verlauf von CodeLens gezeigt wird. Die Standardgrenze beträgt 12 Monate. Das bedeutet, dass CodeLens Ihren Änderungsverlauf nur aus den vergangenen 12 Monaten anzeigt. view: Die aktuelle Anzahl Monate anzeigen. all: Gesamten Änderungsverlauf indizieren. NumberOfMonths: Ändern Sie die Anzahl der Monate, die zum Indizieren des Änderungsverlaufs verwendet werden. Dazu benötigen Sie Team Foundation Server 2013 mit Update 4.
collectionName	Gibt den Namen der Projektsammlung an, für die der CodeIndex-Befehl ausgeführt werden soll. Erforderlich, wenn Sie /CollectionId nicht verwenden.
collectionId	Gibt die ID der Projektsammlung an, für die der CodeIndex-Befehl ausgeführt werden soll. Erforderlich, wenn Sie /CollectionName nicht verwenden

Voraussetzungen

Um den CodeIndex-Befehl verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren sein. Informationen zu Azure DevOps Server finden Sie unter Berechtigungsreferenz.

Beispiele

So zeigen Sie den Status und die Konfiguration der Codeindizierung an:

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

So starten Sie die Indizierung aller Changesets:

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

So beenden Sie die Indizierung zuvor erstellter Changesets und starten die Indizierung nur neuer Changesets:

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

So finden Sie bis zu 50 Dateien, die größer als 10 KB sind

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

So schließen Sie eine bestimmte Datei aus der Indizierung aus und fügen Sie der Liste ignorierter Dateien hinzu:

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

So zeigen Sie alle Dateien an, die nicht indiziert werden

TfsConfig codeIndex /ignoreList:view

So löschen Sie zuvor indizierte Daten und starten die Indizierung neu:

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

So speichern Sie den gesamten Changeset-Verlauf:

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

So entfernen Sie die Größenbeschränkung für temporäre CodeLens-Daten und fahren mit der Indizierung unabhängig von der Größe der temporären Daten fort:

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

So löschen Sie den Codeindex mit Bestätigung:

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

---

Sammlung

Sie können den Sammlungsbefehl verwenden, um eine Projektsammlung aus einer Bereitstellung von Azure DevOps Server anzufügen, zu trennen oder zu löschen. Sie können auch den Sammlungsbefehl verwenden, um die Datenbank einer vorhandenen Sammlung zu duplizieren, umzubenennen und an die Bereitstellung anzufügen. Dieses Verfahren wird manchmal als "Klonen" einer Auflistung bezeichnet.

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

Option	BESCHREIBUNG
attach	Erforderlich, wenn weder /detach noch /delete verwendet wird. Wenn Sie diese Option angeben, müssen Sie auch die Option /collectionDB verwenden. Als Option können Sie auch /collectionName und /clone mit dieser Option verwenden. Wenn Sie die Option /attach verwenden, wird die angegebene Sammlungsdatenbank Ihrer Bereitstellung von Azure DevOps Server hinzugefügt.
create	Erstellt eine Auflistung.
detach	Erforderlich, wenn weder /attach noch /delete verwendet wird. Wenn Sie diese Option angeben, müssen Sie auch die Option /collectionName verwenden. Wenn Sie die Option /detach verwenden, wird die Datenbank für die angegebene Auflistung beendet, und die Sammlung wird von Ihrer Bereitstellung von Azure DevOps Server getrennt.
Löschen	Erforderlich, wenn weder /detach noch /attach verwendet wird. Wenn Sie diese Option angeben, müssen Sie auch die Option /collectionName verwenden. Wenn Sie die Option /delete verwenden, wird die Datenbank für die angegebene Auflistung beendet, und die Auflistung wird dauerhaft von Azure DevOps Server getrennt. Die Auflistungsdatenbank kann nicht mehr erneut an diese oder eine andere Bereitstellung angefügt werden.
CollectionName	Gibt den Namen der Projektsammlung an. Wenn der Name der Auflistung Leerzeichen enthält, müssen Sie den Namen in Anführungszeichen einschließen (z. B. "Meine Auflistung"). Erforderlich, wenn entweder /detach oder /delete verwendet wird. Wenn Sie diese Option mit /detach oder /delete verwenden, wird die Sammlung angegeben, die getrennt oder gelöscht wird. Wenn Sie diese Option mit /attach verwenden, wird ein neuer Name für die Auflistung angegeben. Wenn Sie diese Option sowohl mit /attach als auch mit /clone verwenden, wird der Name für die duplizierte Sammlung angegeben.
CollectionDB	Erforderlich, wenn /attach verwendet wird. Diese Option gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, und den Namen der Sammlungsdatenbank, die auf diesem Server gehostet wird.
ServerName	Gibt den Namen des Servers an, der die Konfigurationsdatenbank für Azure DevOps Server hostet, und den Namen der instance, wenn Sie eine andere instance als die Standard-instance verwenden möchten. Wenn Sie eine instance angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
DatabaseName	Gibt den Namen der Konfigurationsdatenbank an. Standardmäßig lautet der Name dieser Datenbank TFS_ConfigurationDB.
clone	Wenn Sie diese Option angeben, wird die ursprüngliche Sammlungsdatenbank als Klon in SQL Server angefügt, und diese Datenbank wird an Azure DevOps Server angefügt. Diese Option wird hauptsächlich beim Aufteilen einer Projektauflistung verwendet.

Tipp

Die Option /delete löscht die Sammlungsdatenbank nicht aus SQL Server. Nachdem Sie die Sammlungsdatenbank aus Azure DevOps Server gelöscht haben, können Sie die Datenbank manuell aus SQL Server löschen.

Voraussetzungen

Um den Befehl sammlungen verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe "Team Foundation-Administratoren" sowie der lokalen Gruppe "Administratoren" auf dem Computer sein, auf dem TfsConfig ausgeführt wird. Sie müssen auch Mitglied der Sicherheitsrolle sysadmin für alle Instanzen von SQL Server sein, die von Azure DevOps Server Datenbanken verwendet werden. Wenn Ihre Bereitstellung in SharePoint integriert ist und Sie die Option /delete verwenden, müssen Sie auch Mitglied der Gruppe Farmadministratoren für die SharePoint-Farm sein, aus der Sie die Websitesammlung löschen.

Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

Um Sammlungen interaktiv zu verwalten oder eine Sammlung zu erstellen, können Sie den Knoten Projektsammlungen in der Verwaltungskonsole für Azure DevOps verwenden. Weitere Informationen finden Sie unter Verwalten von Projektsammlungen.

Beispiele

Das folgende Beispiel zeigt, wie Sie die Contoso Summer Intern Projects Projektauflistung dauerhaft aus einer Bereitstellung von Azure DevOps Server entfernen.

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.

Im folgenden Beispiel wird gezeigt, wie Sie die Contoso Summer Interns Projects Projektauflistung duplizieren, sie Contoso Winter Interns Projectsbenennen und die doppelte Auflistung an die Bereitstellung von Azure DevOps Server anfügen.

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

---

ColumnStoreIndex

Hinweis

Befehlsverfügbarkeit: Erfordert TFS 2015.2 und höhere Versionen.

Sie verwenden den Befehl columnStoreIndex, um Spaltenspeicherindizes für die Von Ihrer Azure DevOps Server-Bereitstellung verwendeten Datenbanken zu aktivieren oder zu deaktivieren.

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

Option	BESCHREIBUNG
enabled	Gibt an, ob Sie den Spaltenspeicherindex für die angegebene SQL-instance und -Datenbank aktivieren oder deaktivieren.
sqlInstance	Gibt den Namen des Servers an, auf dem die Datenbank gehostet wird, für die der Spaltenspeicherindex aktiviert oder deaktiviert wird, und den Namen des instance, wenn eine andere instance als die Standardeinstellung verwendet wird. Wenn Sie eine instance angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
databaseName	Gibt den Namen der Datenbank an, für die der Spaltenspeicherindex aktiviert oder deaktiviert wird.

Voraussetzungen

Um den Befehl columnStoreIndex verwenden zu können, müssen Sie Mitglied der Sysadmin-Rolle für die angegebene SQL Server instance sein.

Hinweise

Sie würden in der Regel den Befehl columnStoreIndex verwenden, wenn Sie eine Datenbank von einer SQL-instance die den Spaltenspeicherindex unterstützt, in eine Datenbank verschieben, die dies nicht getan hat. In diesem Fall müssen Sie alle Spaltenspeicherindizes deaktivieren, bevor Sie die Datenbanken erfolgreich verschieben können. Wenn Sie eine Datenbank zurück zu einem SQL-instance dem unterstützten Spaltenspeicherindex verschieben, sollten Sie den Spaltenspeicherindex möglicherweise erneut aktivieren, um Speicherplatz zu sparen und die Leistung zu steigern.

Beispiel

Das folgende Beispiel zeigt, wie Sie den Spaltenspeicherindex für eine Datenbank namens TFS_DefaultCollection auf einer SQL-instance aktivieren, die auf einem Server namens ContosoMain auf dem benannten instance TeamDatabasesausgeführt wird.

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

---

ConfigureMail

Konfigurieren Sie den Server, auf dem Azure DevOps Server ausgeführt wird, um einen vorhandenen SMTP-Server für E-Mail-Warnungen zu verwenden.

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

Option	BESCHREIBUNG
FromEmailAddress	Gibt die Adresse an, von der E-Mail-Benachrichtigungen von Azure DevOps Server für ein Einchecken, Ihnen zugewiesenes Arbeitselement oder andere Benachrichtigungen gesendet werden sollen. Diese Adresse wird auch auf Gültigkeit überprüft und muss je nach Serverkonfiguration möglicherweise ein gültiges E-Mail-Konto auf dem E-Mail-Server darstellen. Wenn die Adresse nicht vorhanden oder ungültig ist, wird die Standard-E-Mail-Adresse verwendet.
SmtpHost	Gibt den Namen des Servers an, auf dem der E-Mail-Server gehostet wird.

Voraussetzungen

Um den Befehl configureMail verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren auf dem Azure DevOps-Anwendungsebenenserver sein. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server

Hinweise

Sie können auch die Verwaltungskonsole verwenden, um Azure DevOps Server für die Verwendung eines SMTP-Servers zu konfigurieren.

Beispiel

Das folgende Beispiel zeigt die Syntax, die verwendet wird, um von der E-Mail-Adresse an und TFS@contoso.com den SMTP-E-Mail-Server als ContosoMailServerzu konfigurieren:

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

---

DBCompression

Sie verwenden den Befehl dbCompression, um die Datenbankseitenkomprimierung für die Datenbanken zu aktivieren oder zu deaktivieren, die von Ihrer Azure DevOps Server-Bereitstellung verwendet werden.

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

Option	BESCHREIBUNG
pageCompression	Gibt an, ob Sie die Seitenkomprimierung für die angegebene SQL-instance und -Datenbank aktivieren oder deaktivieren.
sqlInstance	Gibt den Namen des Servers an, auf dem die Datenbank gehostet wird, für die die Seitenkomprimierung aktiviert oder deaktiviert wird, und den Namen der instance, wenn eine andere instance als die Standardeinstellung verwendet wird. Wenn Sie eine instance angeben, müssen Sie das folgende Format verwenden:ServerName\InstanceName
databaseName	Gibt den Namen der Datenbank an, für die die Seitenkomprimierung aktiviert oder deaktiviert wird.
rebuildNow	Optional. Gibt an, ob Datenbankindizes sofort neu erstellt (und bei Bedarf komprimiert oder dekomprimiert) werden sollen. Wenn sie nicht verwendet werden, werden Indizes von einem Hintergrundauftrag neu erstellt, der wöchentlich ausgeführt wird.
Offline	Optional. Wird nur in Kombination mit /rebuildNow verwendet. Wenn /offline nicht angegeben ist, werden Indizes online neu erstellt. Wenn /offline angegeben ist, werden Indizes offline neu erstellt. Dadurch werden andere Vorgänge blockiert, aber möglicherweise schneller als eine Online-Indexneuerstellung.

Voraussetzungen

Um den Befehl dbCompression verwenden zu können, müssen Sie Mitglied der Sysadmin-Rolle für den angegebenen SQL Server instance sein.

Hinweise

In der Regel verwenden Sie den Befehl dbCompression, wenn Sie eine Datenbank aus einer SQL-instance die Komprimierung unterstützt, in eine Datenbank verschieben, die nicht. In diesem Fall müssen Sie die Komprimierung deaktivieren und alle Indizes dekomprimieren, bevor Sie die Datenbanken erfolgreich verschieben können. Wenn Sie eine Datenbank zurück in eine SQL-instance die Die Komprimierung unterstützt, sollten Sie die Komprimierung erneut aktivieren, um Speicherplatz zu sparen.

Mit diesem Befehl wird nur geändert, ob Azure DevOps Server die Datenbankseitenkomprimierung bevorzugt. Ihre Datenbanken müssen weiterhin in einem SQL-instance gehostet werden, dessen Edition die Komprimierung unterstützt. Weitere Informationen finden Sie unter Von den Editionen von SQL Server unterstützte Features.

Beispiel

Das folgende Beispiel zeigt, wie Sie die Seitenkomprimierung sofort aktivieren, wobei Indizes online neu erstellt werden, für eine Datenbank namens TFS_DefaultCollection in einer SQL-instance, die auf einem Server namens ContosoMain auf dem benannten instance TeamDatabasesausgeführt wird.

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

---

DeleteTestResults

Sie verwenden den Befehl deleteTestResults , um alte gespeicherte Testergebnisse aus Ihrem Sammlungsspeicher zu löschen. Dies erfolgt in der Regel, um die Speichergröße zu reduzieren oder die Zeit zu verkürzen, die beim Migrieren von Testergebnissen zu einem neuen Schema erforderlich ist.

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

Option	BESCHREIBUNG
ageInDays	Testergebnisse, die älter als die angegebene Anzahl von Tagen sind, werden gelöscht oder in der Vorschau angezeigt.
sqlInstance	Der Name des Servers, der die Datenbank hostet, für die die Testergebnisse gelöscht oder in der Vorschau angezeigt werden, und der Name des instance, wenn eine andere instance als die Standardeinstellung verwendet wird. Wenn Sie eine instance angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
databaseName	Der Name der Datenbank, für die Testergebnisse gelöscht oder in der Vorschau angezeigt werden.
type	Optional. Der Typ der zu löschenden Testergebnisse. Gültige Werte sind automatisiert, manuell und alle.
preview	Optional. Zeigen Sie die Anzahl der Testergebnisse an, die basierend auf dem Alter in Tagen gelöscht würden, aber löschen Sie diese Ergebnisse nicht.

Voraussetzungen

Um den Befehl deleteTestResults verwenden zu können, müssen Sie Mitglied der sysadmin-Rolle für die angegebene SQL Server instance sein.

Hinweise

Verwenden Sie den Parameter /preview , um die Testergebnisse nach Projektname und Jahr sortiert anzuzeigen, ohne diese Ergebnisse zu löschen.

Beispiel

Das folgende Beispiel zeigt, wie manuelle Testergebnisse gelöscht werden, die älter als 60 Tage für eine Datenbank namens TFS_DefaultCollection auf einer SQL-instance, die auf einem Server namens ContosoMain auf dem benannten instance TeamDatabasesausgeführt wird.

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

---

DeploymentPool

Der Befehl deploymentPool wurde entwickelt, um alle Bereitstellungsgruppen von einem Bereitstellungspool in einen anderen zu migrieren.

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

Option	BESCHREIBUNG
fromPool	Name des Quellpools.
toPool	Name des Zielpools.

---

Identities

Der Identitätsbefehl listet die Sicherheits-ID (SID) von Benutzern und Gruppen in Ihrer Bereitstellung von Azure DevOps Server auf oder ändert sie. In einem der folgenden Szenarien müssen Sie möglicherweise die SID für Benutzer und Gruppen ändern oder aktualisieren:

• Ändern der Domäne Ihrer Bereitstellung

• Wechseln von einer Arbeitsgruppe zu einer Domäne oder von einer Domäne zu einer Arbeitsgruppe

• Migrieren von Konten zwischen Domänen in Active Directory

Hinweis

Sie müssen diesen Befehl nicht ausführen, wenn Sie Domänen innerhalb derselben Active Directory-Gesamtstruktur ändern. Azure DevOps Server verarbeitet automatisch SID-Änderungen für Verschiebungen innerhalb derselben Gesamtstruktur.

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

Option	BESCHREIBUNG
change (Ändern)	Gibt an, dass Sie Identitäten ändern möchten, statt sie aufzuführen.
fromdomain	Erforderlich bei Verwendung von /change. Gibt die ursprüngliche Domäne der Identitäten an, die Sie ändern möchten. Wenn Sie aus einer Arbeitsgruppenumgebung wechseln, gibt dies den Namen des Computers an.
todomain	Erforderlich bei Verwendung von /change. Gibt die Domäne an, für die Sie Identitäten ändern möchten. Wenn Sie zu einer Arbeitsgruppenumgebung wechseln, gibt dies den Namen des Computers an.
account	Gibt den Namen eines Kontos an, für das Sie Identitäten aufführen oder ändern möchten.
toaccount	Gibt den Namen eines Kontos an, in das Sie Identitäten ändern möchten.
SQLInstance	Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, und den Namen der instance, wenn Sie eine andere instance als die Standard-instance verwenden möchten. Wenn Sie eine Instanz angeben, muss das folgende Format verwendet werden: ServerName\InstanceName
DatabaseName	Gibt den Namen der Konfigurationsdatenbank für Azure DevOps Server an.

Voraussetzungen

Um den Identitätsbefehl verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren und Mitglied der Sysadmin-Rolle für alle SQL Server Instanzen sein, die Team Foundation Server verwendet. Weitere Informationen finden Sie unter Festlegen von Administratorberechtigungen für Azure DevOps Server.

Hinweise

Sie können die Datenbank optional angeben, um Identitäten zu ändern, bevor Sie einen Anwendungsebenenserver für die Bereitstellung konfigurieren. Sie können beispielsweise die Datenbank angeben, um das Dienstkonto zu ändern, wenn Sie eine Bereitstellung von Azure DevOps Server klonen.

Wenn Sie Identitäten ändern, müssen das Zielkonto oder die Konten bereits in Windows vorhanden sein.

Sie müssen auf die nächste Identitätssynchronisierung mit Windows warten, damit die Eigenschaften von Konten, die Sie mit diesem Befehl ändern, aktualisiert werden. Diese Anforderung schließt Änderungen von Gruppe zu Benutzer, Benutzer zu Gruppe und Domänenkonto zu lokalem Konto ein.

Beispiele

Das folgende Beispiel zeigt, wie die Namen aller Windows-Benutzer und -Gruppen aufgelistet werden, die in Azure DevOps Server gespeichert sind, und wie angezeigt wird, ob die SID für jeden Benutzer oder jede Gruppe mit der SID in Windows übereinstimmt. Die Domänenadministratoren von Contoso1 haben Domänengruppen wie Contoso1\\Developers und Contoso1\\Testers erstellt, um die Verwaltung von Berechtigungen für Azure DevOps Server, SQL Server Reporting Services und SharePoint-Produkte zu vereinfachen.

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.

Das folgende Beispiel zeigt, wie die SIDs für alle Konten in Azure DevOps Server von der Domäne Contoso1 in die SIDs für Konten mit übereinstimmenden Namen in der ContosoPrime Domäne geändert werden. Nur die SIDs übereinstimmender Kontonamen werden aktualisiert. Wenn das hholt Konto beispielsweise als Contoso1\hholt und ContosoPrime\hholtvorhanden ist, wird die Konto-SID in die SID für ContosoPrime\hholtgeändert. Wenn das ContosoPrime\hholt Konto nicht vorhanden ist, wird die SID für nicht aktualisiert Contoso1\hholt.

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

Das folgende Beispiel zeigt, wie Sie das Konto für ein einzelnes Benutzerkonto in Contoso1\hholtdas Konto für ein anderes Benutzerkonto ändern, ContosoPrime\jpeoples.

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

Das folgende Beispiel zeigt, wie die SID des NT AUTHORITY\NETWORK SERVICE Dienstkontos geändert wird, das bei der Bereitstellung von Azure DevOps Server verwendet wird, wenn die Domäne der Bereitstellung von in Contoso1ContosoPrimegeändert wird. Um ein Systemkonto, beispielsweise Netzwerkdienst, zu ändern, müssen Sie einem zweistufigen Prozess folgen. Sie ändern zunächst das Dienstkonto von NT AUTHORITY\NETWORK SERVICE in ein Domänenkonto in der neuen Domäne TempSVCund dann auf dem Server in der neuen Domäne wieder in NETZWERKDIENST. Die Konfigurationsdatenbank wird auf dem Server gehostet, der auf der benannten instance TeamDatabases in SQL Server benannt ContosoMain ist.

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"

---

Aufträge

Sie können den Befehl aufträge verwenden, um eine Protokolldatei zu erstellen, die die Details der letzten Auftragsaktivität für eine bestimmte Projektsammlung enthält, oder um einen Auftrag für eine oder alle Projektsammlungen erneut zu versuchen.

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

Option	BESCHREIBUNG
retry	Erforderlich, wenn /dumplog nicht verwendet wird. Gibt an, dass der letzte Auftrag für die angegebene Projektauflistung erneut entfernt wird. Wenn Sie diese Option verwenden, müssen Sie auch die Option /CollectionName oder /CollectionID verwenden.
dumplog	Erforderlich, wenn /retry nicht verwendet wird. Gibt an, dass die letzte Auftragsaktivität für die Sammlung an eine Protokolldatei gesendet wird. Wenn Sie diese Option verwenden, müssen Sie auch die Option /CollectionName oder /CollectionID verwenden.
CollectionName	Erforderlich, wenn /CollectionID nicht verwendet wird. Gibt den Namen der Auflistung an, für die der letzte Auftrag entweder wiederholt (/wiederholen) oder protokolliert wird (/dumplog). Wenn Sie alle Sammlungen angeben möchten, können Sie ein Sternchen (*) verwenden.
CollectionID	Erforderlich, wenn /CollectionName nicht verwendet wird. Gibt die Identifikationsnummer der Sammlung an, für die der letzte Auftrag entweder wiederholt (/wiederholen) oder protokolliert wird (/dumplog).

Voraussetzungen

Um den Befehl jobs verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren sein. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

Wenn Sie einen Auftrag interaktiv wiederholen möchten, können Sie die Verwaltungskonsole für Azure DevOps öffnen, die Registerkarte Status für die Sammlung und dann Auftrag wiederholen auswählen. Weitere Informationen finden Sie unter Öffnen der Azure DevOps-Verwaltungskonsole.

Beispiel

Das folgende Beispiel zeigt, wie Sie eine Protokolldatei erstellen, die die letzte Auftragsaktivität für die Contoso Summer Intern Projects Projektsammlung in Azure DevOps Server auflistet.

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

---

OfflineDetach

Sie verwenden den Befehl offlineDetach , um eine Offlinesammlungsdatenbank in eine getrennte Offlinesammlungsdatenbank zu verwandeln.

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

Option	BESCHREIBUNG
configurationDB	Gibt den Namen der zu verwendenden Konfigurationsdatenbank an.
collectionDB	Gibt den Namen der zu lösenden Sammlungsdatenbank an.

Voraussetzungen

Um den Befehl offlineDetach verwenden zu können, müssen Sie Mitglied der Sysadmin-Rolle für die angegebene SQL Server instance sein.

Hinweise

Dieser Befehl ändert das Schema der angegebenen Sammlungsdatenbank und sollte niemals für Datenbanken ausgeführt werden, die von einer Team Foundation Server-Bereitstellung verwendet werden. Wenn Ihre Datenbanken von einer Team Foundation Server-Bereitstellung verwendet werden, verwenden Sie TfsConfig collection /detach stattdessen.

Dieser Befehl ist nützlich, wenn Sie eine einzelne Sammlungsdatenbank aus der Sicherung wiederherstellen müssen, ohne andere Sammlungsdatenbanken wiederherzustellen, die Teil derselben Azure DevOps Server Bereitstellung sind. Bisher war es erforderlich, einen vollständigen und konsistenten Satz von Datenbanken (Konfiguration und alle Sammlungen) in einer Stagingumgebung wiederherzustellen, eine Azure DevOps Server Bereitstellung mithilfe dieser Datenbanken zu konfigurieren und die eine sammlung von Interesse zu trennen.

Stattdessen können Sie jetzt konsistente Kopien der Konfigurationsdatenbank und der gewünschten Sammlungsdatenbank wiederherstellen und den Befehl offlineDetach ausführen. Die getrennte Sammlungsdatenbank kann dann an jede Azure DevOps Server Bereitstellung mit einer entsprechenden Version angefügt werden.

Beispiel

Das folgende Beispiel veranschaulicht das Trennen einer Sammlungsdatenbank namens TFS_PrimaryCollectionmithilfe einer Konfigurationsdatenbank mit dem Namen TFS_Configuration, wobei beide auf einer SQL-instance auf einem Server namens ContosoTemp auf dem benannten instance Backupsausgeführt werden.

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

---

Proxy

Sie können den Proxybefehl verwenden, um die von Azure DevOps Proxy Server verwendeten Einstellungen zu aktualisieren oder zu ändern. Azure DevOps-Proxyserver bietet Unterstützung für verteilte Teams bei der Verwendung der Versionskontrolle, indem ein Cache mit heruntergeladenen Versionskontrolldateien am Speicherort des verteilten Teams verwaltet wird. Durch das Konfigurieren von Azure DevOps-Proxyserver können Sie die Bandbreite, die für Wide Area-Verbindungen benötigt wird, erheblich reduzieren. Außerdem müssen Sie das Herunterladen und Zwischenspeichern von Versionsdateien nicht verwalten; die Verwaltung der Dateien ist für den Entwickler, der die Dateien verwendet, ersichtlich. In der Zwischenzeit werden alle Metadatenaustausche und Dateiuploads weiterhin in Azure DevOps Server angezeigt. Wenn Sie das Azure DevOps Services verwenden, um Ihr Entwicklungsprojekt in der Cloud zu hosten, können Sie den Proxybefehl verwenden, um nicht nur den Cache für Projekte in der gehosteten Sammlung zu verwalten, sondern auch um einige der einstellungen zu verwalten, die von diesem Dienst verwendet werden.

Weitere Informationen zum Installieren des Azure DevOps-Proxyservers und zur Erstkonfiguration des Proxys:

Weitere Informationen finden Sie unter Vorgehensweise: Installieren des Azure DevOps-Proxyservers und Einrichten eines Remotestandorts. Weitere Informationen zum Konfigurieren des Proxys auf Clientcomputern finden Sie in der Azure DevOps-Versionskontrollbefehlsreferenz.

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

Option	BESCHREIBUNG
add	Fügt den angegebenen Server oder die angegebene Auflistung der Proxyliste in der Datei Proxy.config hinzu. Sie können /add mehrmals ausführen, um weitere Auflistungen oder Server einzuschließen. Wenn Sie /add mit einer Sammlung verwenden, die auf Azure DevOps Services gehostet wird, werden Sie aufgefordert, Ihre Anmeldeinformationen für Azure DevOps Services einzugeben.
change (Ändern)	Ändert die Anmeldeinformationen, die als Dienstkonto für Azure DevOps Services gespeichert sind. Die Option /change wird nur für Azure DevOps Services verwendet. Sie sollte nicht für lokale Bereitstellungen von Azure DevOps Server verwendet werden.
Löschen	Entfernt den angegebenen Server oder die angegebene Auflistung von der Proxyliste in der Datei Proxy.config.
account	Gibt das Konto an, das als Dienstkonto für den Proxy in Azure DevOps Services verwendet wird. Diese Option wird nur für Azure DevOps Services in Verbindung mit der Option /change verwendet. Das Standarddienstkonto, das für Azure DevOps Services verwendet wird, ist "Kontodienst".
continue	Setzt die Ausführung des Befehls fort, auch wenn bei der Überprüfung Warnungen ausgegeben werden.
Sammlung	Gibt die URL der Projektsammlung an, die auf Azure DevOps Services AccountName.DomainName/CollectionName im Format gehostet wird.
account	Gibt den Namen des Kontos an, das als Dienstkonto für Azure DevOps Services verwendet wird. Enthält der Kontoname Leerzeichen, muss der Name in Anführungszeichen ("") eingeschlossen sein. Alle Sonderzeichen in Kontonamen müssen entsprechend der Befehlszeilensyntax angegeben werden.
account	Gibt die URL einer Azure DevOps Server Bereitstellung im ServerURL:Port/tfs Format an.
PersonalAccessTokenFile	Gibt optional den Pfad zu einer Datei an, die ein persönliches Zugriffstoken enthält. Dieses Token wird beim Registrieren eines Proxys für die Sammlung oder das Konto authentifiziert. (In TFS 2018 Update 1 hinzugefügt)
inputs	Optional. Gibt zusätzliche Einstellungen und Werte an, die beim Konfigurieren des Proxys verwendet werden sollen.! Beispielsweise können Werte für GvfsProjectName und GvfsRepositoryName verwendet werden, um ein Git-Repository für die Verwendung mit Git Virtual File System (GVFS) zu konfigurieren (in TFS 2018 Update 1 hinzugefügt)

Voraussetzungen

Um den Proxybefehl verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren und Administrator auf dem Proxyserver sein. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

Sie verwenden den Proxybefehl, um die vorhandene Konfiguration von Azure DevOps Server Proxy zu aktualisieren. Sie können den Proxybefehl nicht für die Erstinstallation und Konfiguration des Proxys verwenden.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie der Proxyliste eine Azure DevOps Server Bereitstellung namens FABRIKAM hinzufügen.

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

Im folgenden Beispiel wird gezeigt, wie Sie der Proxyliste mithilfe eines persönlichen Zugriffstokens zur Authentifizierung eine auf Azure DevOps Services gehostete Projektsammlung hinzufügen. Dieses Token wird nur verwendet, um den Proxy beim Azure DevOps Services-Konto zu registrieren. Das Standarddienstkonto wird weiterhin zum Ausführen des Proxys verwendet. Dieser Parameter wurde in TFS 2018 Update 1 hinzugefügt, um die Registrierung eines Proxys bei Azure DevOps Services zu unterstützen, ohne dass eine Anmeldeaufforderung erforderlich ist.

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

Das folgende Beispiel zeigt, wie Sie der Proxyliste eine Projektsammlung hinzufügen. In diesem Beispiel wird ein persönliches Zugriffstoken verwendet, um sich bei der mit dem /Collection -Parameter angegebenen Auflistung zu authentifizieren. Das zu verwendende persönliche Zugriffstoken wird in einer Datei unter c:\PersonalAccessToken.txtgespeichert.

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

Das folgende Beispiel zeigt, wie Sie das dienstkonto ändern, das vom Proxy für die auf Azure DevOps Services gehostete Projektsammlung verwendet wird. Die Auflistung heißt PhoneSaver, der kontoname, der für Azure DevOps Services verwendet wird, und HelenaPetersen.fabrikam.comdas vom Proxy verwendete Dienstkonto wird in My Proxy Service Accountgeändert. Da der Kontoname Leerzeichen enthält, werden Anführungszeichen verwendet, um den Namen einzuschließen.

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

Das folgende Beispiel zeigt, wie Sie ein Git-Repository zur Verwendung mit GVFS hinzufügen.

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

---

RebuildWarehouse

Sie können den Befehl rebuildWarehouse verwenden, um die SQL Server Reporting Services und SQL Server Analysis Services Datenbanken neu zu erstellen, die Azure DevOps Server verwendet.

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

Option	BESCHREIBUNG
Microsoft.analysisservices	Erforderlich, wenn /all nicht verwendet wird. Gibt an, dass nur die Datenbank für Analysis Services neu erstellt wird. Wenn keine Datenbank für Analysis Services vorhanden ist, müssen Sie auch die Option /reportingDataSourcePassword verwenden.
alle	Erforderlich, wenn /analysisServices nicht verwendet wird. Gibt an, dass alle Berichts- und Analysedatenbanken, die Azure DevOps Server verwendet, neu erstellt werden.
reportingDataSourcePassword	Erforderlich, wenn die Datenbank "TFS_Analysis" nicht vorhanden ist. Gibt das Kennwort des Kontos an, das als Datenquellenkonto für SQL Server Reporting Services (TFSReports) verwendet wird. Weitere Informationen finden Sie unter Dienstkonten und Abhängigkeiten in Azure DevOps Server.

Voraussetzungen

Um den Befehl rebuildWarehouse verwenden zu können, müssen Sie Mitglied der folgenden Gruppen sein:

• Die Sicherheitsgruppe Azure DevOps-Administratoren und die Sicherheitsgruppe Administratoren auf dem Server oder den Servern, auf denen die Verwaltungskonsole für Azure DevOps ausgeführt wird

• Die sysadmin-Gruppe auf dem Server oder den Servern, auf denen die instance von SQL Server ausgeführt wird, die die Datenbanken für Azure DevOps Server

Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

Sie können diesen Befehl verwenden, wenn Sie eine Projektsammlung verschieben oder aufteilen, Daten wiederherstellen oder die Konfiguration Ihrer Bereitstellung anderweitig ändern.

Um die neuerstellung dieser Datenbanken interaktiv zu starten, können Sie den Knoten Berichterstellung in der Verwaltungskonsole für Azure DevOps verwenden. Weitere Informationen finden Sie unter Öffnen der Azure DevOps-Verwaltungskonsole.

Beispiel

Das folgende Beispiel zeigt, wie Die Analysis Services-Datenbank für eine Bereitstellung von Azure DevOps Server neu erstellt wird.

TfsConfig rebuildWarehouse /analysisServices

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

---

Registerdb

Verwenden Sie registerDB, um den Namen des Servers zu aktualisieren, der die Konfigurationsdatenbank in Azure DevOps Server hostet. Sie können diesen Befehl beim Wiederherstellen der Konfigurationsdatenbank auf neuer Hardware oder beim Ändern der Domäne einer Bereitstellung verwenden.

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

Option	BESCHREIBUNG
SQLInstance	Erforderlich. Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, und den Namen des instance, wenn Sie eine andere instance als die Standard-instance verwenden möchten. Wenn Sie einen instance angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
databaseName	Erforderlich. Gibt den Namen der Konfigurationsdatenbank an. Standardmäßig ist dies Tfs_Configuration.

Voraussetzungen

Um den Befehl registerDB verwenden zu können, müssen Sie Mitglied der Gruppe Azure DevOps-Administratoren auf dem Anwendungsebenenserver für Azure DevOps und Mitglied der Gruppe sysadmin in SQL Server auf dem Datenebenenserver für Azure DevOps sein. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

Sichern Sie die Datenbanken für Azure DevOps Server, bevor Sie diesen Befehl verwenden.

Damit der befehl registerDB erfolgreich ist, müssen die folgenden Anwendungspools und Programme ausgeführt werden:

• Azure DevOps Server Anwendungspool (Anwendungspool)
• ReportServer (Anwendungspool)
• SQL Server Reporting Services (Programm)

Sie müssen den genauen Namen oder die Adresse der Konfigurationsdatenbank angeben, damit dieser Befehl ordnungsgemäß funktioniert. Wenn Sie den Server ändern müssen, auf dem diese Datenbank gespeichert ist, müssen Sie sicherstellen, dass Azure DevOps Server auf den neuen Speicherort verweist.

Beispiel

Im folgenden Beispiel wird Azure DevOps Server an eine Konfigurationsdatenbank umgeleitet, die sich auf dem Server ContosoMain im SQL Server instance TeamDatabasesbefindet.

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

---

RemapDBs

Der Befehl remapDBs leitet Azure DevOps Server an die zugehörigen Datenbanken um, wenn sie auf mehreren Servern gespeichert sind und Sie die Konfiguration Ihrer Bereitstellung wiederherstellen, verschieben oder anderweitig ändern. Beispielsweise müssen Sie Azure DevOps Server zu allen Datenbanken für Projektsammlungen umleiten, wenn sie auf einem oder anderen Server von der Konfigurationsdatenbank gehostet werden. Sie müssen auch Azure DevOps Server an den Server oder die Server umleiten, auf denen SQL Server Analysis Services oder SQL Server Reporting Services ausgeführt wird, wenn diese Datenbanken auf einem separaten Server oder instance von der Konfigurationsdatenbank gehostet werden.

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

Option	BESCHREIBUNG
DatabaseName	Gibt den Namen des Servers an, der die Datenbank hostet, die Sie für Azure DevOps Server zuordnen möchten, zusätzlich zum Namen der Datenbank selbst.
SQLInstances	Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, zusätzlich zum Namen des instance, wenn Sie eine andere instance als die Standard-instance verwenden möchten. Wenn Sie mehrere Server angeben, müssen Sie ein Komma verwenden, um mehrere Server- und instance Namenpaare zu trennen.
AnalysisInstance	Optional. Gibt den Namen des Servers und instance an, der SQL Server Analysis Services hostet. Verwenden Sie diese Option, um den Server und instance anzugeben, der die Analysis Services-Datenbank hostet.
AnalysisDatabaseName	Optional. Gibt den Namen der Analysis Services-Datenbank an, die Sie mit Azure DevOps Server verwenden möchten, wenn Sie mehr als eine solche Datenbank auf dem Server haben, den Sie mit der Option /AnalysisInstance angegeben haben.
preview	Optional. Zeigt die Aktionen an, die Sie zum Aktualisieren der Konfiguration ausführen müssen.
continue	Optional. Gibt an, dass der RemapDB-Befehl auch dann fortgesetzt werden soll, wenn beim Versuch, eine oder mehrere Datenbanken zu suchen, ein Fehler auftritt. Wenn Sie die Option /continue verwenden, werden alle Sammlungen, deren Datenbanken nicht auf dem oder den von Ihnen angegebenen Servern gefunden werden, für die Verwendung des Servers und instance, die die Konfigurationsdatenbank hosten, neu konfiguriert.

Voraussetzungen

Um den Befehl remapDBs verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren und Mitglied der Sicherheitsgruppe sysadmin für alle SQL Server Datenbanken sein, die Azure DevOps Server verwendet. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

Sie verwenden den Befehl remapDBs, um Azure DevOps Server neu zu konfigurieren, um verschiedene Server und Instanzen von SQL Server von den Servern und Instanzen in der ursprünglichen Installation zu verwenden.

Beispiel

Das folgende Beispiel zeigt, wie Sie Azure DevOps Server an die Konfigurationsdatenbank TFS_Configurationumleiten. Diese Datenbank wird auf ContosoMain dem benannten instance TeamDatabasesgehostet. Die Projektsammlungsdatenbanken werden sowohl in als auch ContosoMain\TeamDatabases in der Standard-instance auf Contoso2gespeichert.

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

---

RepairJobQueue

Sie verwenden den Befehl repairJobQueue , um geplante Aufträge zu beheben, die für Bereitstellungs- und Sammlungshosts nicht mehr ausgeführt werden.

TfsConfig repairJobQueue

Voraussetzungen

Um den Befehl repairJobQueue verwenden zu können, müssen Sie Mitglied der lokalen Administratorgruppe auf dem Computer sein, auf dem TfsConfig ausgeführt wird. Sie müssen auch Mitglied der Sicherheitsrolle sysadmin für alle SQL Server-Instanzen sein, die von der Azure DevOps Server-Bereitstellung verwendet werden.

Hinweise

Sie verwenden in der Regel den Befehl repairJobQueue , wenn geplante Aufträge nicht ausgeführt werden.
Der Befehl akzeptiert keine Argumente und erfordert, dass die Azure DevOps Server Bereitstellung konfiguriert ist.

Beispiel

TfsConfig repairJobQueue

---

Einstellungen

Sie können den Einstellungsbefehl verwenden, um Änderungen am Uniform Resource Locator (URL) zu automatisieren, der von der Benachrichtigungsschnittstelle und für die Serveradresse für Azure DevOps Server verwendet wird. Standardmäßig stimmen die Benachrichtigungsschnittstellen-URL und die Server-URL in Azure DevOps Server überein. Sie können jedoch separate URLs konfigurieren. Sie können beispielsweise eine andere URL für die automatischen E-Mails verwenden, die Azure DevOps Server generiert. Sie müssen dieses Tool auf Anwendungsebene ausführen, um alle Server so zu aktualisieren, dass sie die neuen URLs verwenden.

Um diese URLs interaktiv zu ändern oder einfach nur die aktuellen Einstellungen anzuzeigen, können Sie die Verwaltungskonsole für Azure DevOps verwenden. Weitere Informationen finden Sie unter Schnellübersicht zu Verwaltungsaufgaben.

TfsConfig settings [/publicURL:URL]

Option	BESCHREIBUNG
publicUrl	Gibt die URL des Anwendungsebenenservers für Azure DevOps an. Dieser Wert wird in der Konfigurationsdatenbank für Azure DevOps gespeichert.

Voraussetzungen

Sie müssen Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren und der Gruppe Administratoren auf dem Anwendungsebenenserver sein. Weitere Informationen finden Sie unter Festlegen von Administratorberechtigungen für Azure DevOps Server.

Hinweise

Der Einstellungsbefehl ändert die Verbindungsinformationen für die Server-zu-Server-Kommunikation in einer Bereitstellung von Azure DevOps Server. Die IN /publicURL angegebene URL muss für alle Server innerhalb der Bereitstellung verfügbar sein.

Beispiel

Im folgenden Beispiel wird der Wert von NotificationURL in http://contoso.example.com/tfs und der Wert von ServerURL in geändert http://contoso.example.com:8080/tfs.

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

---

Einrichten

Sie verwenden den Setupbefehl , um Features zu deinstallieren, die derzeit auf dem Computer konfiguriert sind, auf dem Sie den Befehl ausführen.

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

Option

Beschreibung

/uninstall

Gibt mindestens ein Feature an, das auf dem Computer deinstalliert werden soll, auf dem Sie den Befehl ausführen. Zu den Optionen gehören: All, ApplicationTier, Search und VersionControlProxy.

Voraussetzungen

Um den Setupbefehl verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren sein.

Beispiele

Im folgenden Beispiel werden alle Azure DevOps Server Features vom aktuellen Computer deinstalliert.

TfsConfig setup /uninstall:All

Im folgenden Beispiel werden die Anwendungsebene und buildfeatures vom aktuellen Computer deinstalliert.

TfsConfig setup /uninstall:ApplicationTier 

---

TCM

Beim Upgrade auf die neueste Version von Azure DevOps Server versucht das System automatisch, die Testverwaltungskomponenten, einschließlich Testpläne und -suites, zu aktualisieren.

Wenn die automatische Migration fehlschlägt, verwenden Sie den TCM-Befehl , um Ihre Testpläne und Testsammlungen manuell auf die jeweiligen Arbeitselementtypen (WITs) zu aktualisieren.

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

Option

Beschreibung

/upgradeTestPlans

Erforderlich, es sei denn ,/upgradeStatus wird verwendet.

Konvertiert vorhandene Testpläne und Testsammlungen so, dass sie auf die arbeitsaufgabenbasierten Testpläne und Testsammlungen verweisen. Aktualisiert außerdem vorhandene Testverwaltungsdaten und Links zwischen anderen vorhandenen Testartefakten wie Testpunkten, Testläufen und Testergebnissen.

/upgradeStatus

Erforderlich, es sei denn , /upgradeTestPlans wird verwendet.

Meldet die Migration status von Testdaten für das angegebene Projekt. Zeigt außerdem an, ob das angegebene Projekt Testpläne enthält.

/CollectionName:CollectionName

Erforderlich. Gibt die Projektauflistung an, die das Projekt enthält, für das Sie Testdaten migrieren oder die Migration status überprüfen möchten.

Wenn im Namen der Projektauflistung Leerzeichen vorhanden sind, schließen Sie den Namen in Anführungszeichen ein, z. B. "Fabrikam Fiber Collection".

/TeamProjectName:TeamProjectName

Erforderlich. Gibt das Projekt an, für das Sie Testdaten migrieren oder die Migration status überprüfen möchten. Dieses Projekt muss in der Auflistung definiert werden, die Sie mit dem Parameter /collectionName angegeben haben.

Wenn im Namen des Projekts Leerzeichen vorhanden sind, schließen Sie den Namen in Anführungszeichen ein, z. B. "Mein Projekt".

Voraussetzungen

Sie müssen Mitglied der Sicherheitgruppe Team Foundation-Administratoren und ein Adminstrator auf dem Anwendungsebenenserver sein.

Weitere Informationen finden Sie unter Festlegen von Administratorberechtigungen für Azure DevOps Server.

Hinweise

Ihr Anwendungsebenenserver muss auf die neueste Version von Azure DevOps Server 2019 aktualisiert werden, um diesen Befehl verwenden zu können.

Bevor Sie den TCM-Befehl verwenden können, müssen Sie zuerst die Arbeitsaufgabendefinition des Testplans und die Testplankategorie in das Projekt importieren.

Weitere Informationen zur Migration und zur Verwendung dieses Befehls finden Sie unter Manuelle Updates zur Unterstützung der Testverwaltung.

Der TCM-Befehl wird auf einzelne Projekte angewendet. Wenn Sie Testpläne in mehreren Projekten aktualisieren müssen, müssen Sie sie für jedes Projekt einzeln ausführen.

Sie müssen den TCM-Befehl aus dem Verzeichnis tools für Azure DevOps Server ausführen. Standardmäßig lautet dieser Speicherort: drive:\%programfiles%\TFS 12.0\Tools.

Sie verwenden den TCM-Befehl nur für den Fall, dass die automatische Migration vorhandener Testdaten fehlschlägt.

Weitere Informationen zur Migration und zur Verwendung dieses Befehls finden Sie unter Manuelle Updates zur Unterstützung der Testverwaltung. Wenn Sie nicht auf Testpläne oder Testsammlungen zugreifen können, die vor dem Serverupgrade definiert wurden, führen Sie TFSConfig TCM upgradeStatus aus, um die status der Migration zu ermitteln.

Sie führen den TCM-Befehl für ein einzelnes Projekt aus. Wenn Sie mehrere Projekte aktualisieren müssen, müssen Sie es für jedes Projekt nacheinander ausführen.

Beispiele

Das folgende Beispiel zeigt, wie Sie die status des Testplanupgrades für das Fabrikam Fiber-Projekt überprüfen, das in der Standardprojektsammlung (DefaultCollection) gehostet wird:

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

---

Der Ordner „Unattend“

Befehlsverfügbarkeit: Azure DevOps Server 2019

Der Befehl unattend richtet sich an Benutzer, die mit Azure DevOps Server und dem Konfigurationsprozess vertraut sind und Azure DevOps Server auf verschiedenen Computern installieren müssen.

Wenn Sie beispielsweise Azure DevOps Build verwenden, können Sie den Befehl unattend verwenden, um mehrere Buildserver mit derselben Konfigurationsdatei zu installieren.

Verwenden Sie die Option /create , um eine Datei ohne Installation zu erstellen. Diese Datei definiert alle Konfigurationsparameter für eine Azure DevOps Server Installation. Verwenden Sie als Nächstes die Option /configure , um die Konfiguration tatsächlich auszuführen.

Mit diesem Prozess können Sie Azure DevOps Server von Anfang bis Ende konfigurieren, ohne während des Installationsvorgangs Eingaben bereitstellen zu müssen. Im Fall von mehreren Installationen wird hierdurch außerdem sichergestellt, dass auf mehreren Servern genau die gleichen Konfigurationsparameter verwendet werden.

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

Option	BESCHREIBUNG
create	Erstellt die Datei für die unbeaufsichtigte Installation mit dem Namen und den Parametern, den bzw. die Sie angeben.
KONFIGURIEREN	Konfiguriert Azure DevOps Server mithilfe der von Ihnen angegebenen Unattend-Datei und parametern. Sie müssen /type oder /unattendfile mit dieser Option verwenden.
Typ	Gibt den zu verwendenden Konfigurationstyp an. Wenn Sie /configure verwenden, ist entweder /type oder /unattendfile erforderlich, Sie können jedoch nicht beide Optionen verwenden.
Unattendfile	Gibt die zu erstellende oder zu verwendende Datei für die unbeaufsichtigte Konfiguration an, abhängig davon, oder der anfängliche Parameter /create oder /configure lautet. Wenn Sie /configure verwenden, ist entweder /unattendfile oder /type erforderlich.
inputs	Optional. Wenn Sie /create verwenden, geben Sie Einstellungen und Werte für die Erstellung der Datei für die unbeaufsichtigte Installation an. Wenn Sie /configure verwenden, geben Sie zusätzliche Einstellungen und Werte an, die in Verbindung mit der Datei für die unbeaufsichtigte Installation verwendet werden sollen. Alternativ zur Verwendung von /inputs können Sie die Datei für die unbeaufsichtigte Installation auch manuell in einem Nur-Text-Editor bearbeiten. Dies ist für bestimmte Eingabetypen wie ServiceAccountPassword oder PersonalAccessToken erforderlich, da diese Geheimniswerte nicht mit dem Parameter /inputs festgelegt werden können.
Überprüfen	Optional. Gibt eine Konfigurationsausführung an, bei der nur Überprüfungen für die jeweilige Datei für die unbeaufsichtigte Installation, die Eingaben und den Konfigurationstyp durchgeführt werden. Dies ist eine Alternative zu einer vollständigen Konfiguration.
continue	Optional. Gibt an, dass /create oder /configure weiterhin ausgeführt werden soll, unabhängig von Warnungen, die bei den Überprüfungen ausgegeben werden.

InstallType	BESCHREIBUNG
NewServerBasic	Konfiguriert die wesentlichen Entwicklungsdienste für Azure DevOps Server. Dazu gehören Quellcodeverwaltung, Arbeitselemente, Build und optional Search.
NewServerAdvanced	Konfiguriert die wesentlichen Entwicklungsdienste und ermöglicht die optionale Konfiguration der Integration mit Reporting Services.
Aktualisieren	Upgrades Azure DevOps Server von einer unterstützten früheren Version auf die aktuelle Version.
PreProductionUpgrade	Testen Sie das Upgrade auf einer vorhandenen Azure DevOps Server Bereitstellung in einer Präproduktionsumgebung. Dies erfolgt in der Regel mithilfe von Datenbanken, die aus Produktionssicherungen wiederhergestellt werden. Dieses Szenario umfasst zusätzliche Schritte, um sicherzustellen, dass die neue Bereitstellung die Produktionsbereitstellung nicht beeinträchtigt.
ApplicationTierOnlyBasic	Konfigurieren Sie eine neue Anwendungsebene mithilfe vorhandener Einstellungen aus der bereitgestellten Konfigurationsdatenbank. Mit dieser Option können Sie mithilfe vorhandener Einstellungen schnell eine neue Anwendungsebene einrichten und ausführen. Wenn Sie vorhandene Einstellungen ändern möchten, verwenden Sie stattdessen den Typ Advanced ApplicationTierOnlyAdvanced.
ApplicationTierOnlyAdvanced	Konfigurieren Sie eine neue Anwendungsebene mit voller Kontrolle über alle Einstellungen. Einstellungen werden standardmäßig auf vorhandene Werte aus der angegebenen Konfigurationsdatenbank festgelegt. Wenn Sie alle vorhandenen Einstellungen beibehalten möchten, verwenden Sie stattdessen den Typ ApplicationTierOnlyBasic.
Klon	Konfigurieren Sie eine neue Azure DevOps Server Bereitstellung, bei der es sich um einen Klon einer vorhandenen Bereitstellung handelt. Dies erfolgt in der Regel mithilfe von Datenbanken, die aus Produktionssicherungen wiederhergestellt wurden, um eine Umgebung zu erstellen, in der Konfigurationsänderungen, Erweiterungen und andere Änderungen getestet werden können. Dieses Szenario umfasst zusätzliche Schritte, um sicherzustellen, dass die neue Bereitstellung die Produktionsbereitstellung nicht beeinträchtigt.
Proxy	Konfiguriert einen Versionskontrollproxydienst.

Voraussetzungen

• Sie müssen Mitglied der Gruppe Administratoren auf dem Computer sein, auf dem Sie die Software installieren.

• Abhängig vom Installationstyp benötigen Sie eventuell außerdem zusätzliche Administratorberechtigungen.

Wenn Sie beispielsweise den Befehl unattend verwenden, um Azure DevOps Server zu installieren, müssen Sie Mitglied der Gruppe sysadmin auf der instance von SQL Server sein, die Azure DevOps Server unterstützt. Weitere Informationen finden Sie im Abschnitt Q & A unter Hinzufügen von Administratoren auf Serverebene zu Azure DevOps Server.

Hinweise

Bevor Sie den Befehl unattend verwenden können, um Azure DevOps Server zu konfigurieren, müssen Sie die Dienstkonten erstellen, die Sie im Rahmen Ihrer Bereitstellung verwenden werden. Außerdem müssen Sie sämtliche erforderliche Software für den gewählten Installationstyp installieren. Dazu gehört auch Azure DevOps Server selbst. Sie müssen Azure DevOps Server installieren, aber nicht konfigurieren, da der Befehl für die unattend-Installation dies für Sie übernimmt.

Der Befehl unattend konfiguriert Azure DevOps Server Komponenten. Es wird keine Erstinstallation der Software durchgeführt. Die Software wird entsprechend Ihren Angaben konfiguriert, nachdem die Bits auf dem Computer vorhanden sind.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Unbeaufsichtigte Datei für eine Einfache Installation von Azure DevOps Server erstellen.

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

In diesem Beispiel wird die Datei für die unbeaufsichtigte Installation im gleichen Verzeichnis wie der Befehl erstellt. Außerdem wird mit dem Befehl eine Protokolldatei erstellt, und der Speicherort der Datei wird bei Ausführung des Befehls zurückgegeben.

Das folgende Beispiel zeigt, wie Sie während der Konfiguration ein Git-Repository für die Verwendung mit GVFS angeben.

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

Das folgende Beispiel zeigt, wie Sie eine Unbeaufsichtigte Datei für die Konfiguration eines Azure DevOps-Proxyservers erstellen.

Wichtig

Wenn die Administratoren in diesem Beispiel ein persönliches Zugriffstoken für die Authentifizierung verwenden möchten, müssen sie die Datei manuell bearbeiten, um den Wert des persönlichen Zugriffstokens anzugeben. Dies kann durch Hinzufügen einer Zeile für das persönliche Zugriffstoken in der erstellten Unattend-Datei wie folgt erreicht werden: PersonalAccessToken=PersonalAccessTokenValue.

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

Das folgende Beispiel zeigt, wie Sie eine Unbeaufsichtigte Datei für die Konfiguration von Azure DevOps Server Build auf einem Server mit FabrikamFiber\BuildSVC als Builddienstkonto erstellen und anschließend Azure DevOps Server Build mithilfe dieser Unbeaufsichtigten Datei konfigurieren.

Wichtig

In diesen Beispiel bearbeitet der Administrator die Datei für die unbeaufsichtigte Installation nach deren Erstellung manuell, um das Kennwort für das Builddienstkonto anzugeben. Wenn Sie das Kennwort als Eingabe mithilfe von ServiceAccountPassword=Password; hinzufügen, werden die Kennwortinformationen nicht zur Datei hinzugefügt.

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

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

Der erste Befehl gibt Folgendes zurück:

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

Der zweite Befehl gibt die folgenden Informationen zurück, einschließlich des Namens des Servers, auf dem Azure DevOps Build konfiguriert FabrikamFiberTFS wurde, und der Projektsammlung, die dem Controller DefaultCollectionzugeordnet ist:

    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

Der Ziplogs-Befehl dient zum Sammeln von Protokollen und Löscht eine ZIP-Datei unter ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

---