Verwenden von TFSConfig zum Verwalten von Azure DevOps lokal

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

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

TFSConfig kann von 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 eine Verbindung mit den verschiedenen Servern und Diensten herstellen können, die Teil Ihrer TFS-Bereitstellung sind, und der Benutzer, der TFSConfig ausführt, muss über Administratorberechtigungen für diese Server und Dienste verfügen. Die Anforderungen für bestimmte Befehle werden unten aufgeführt.

Viele TFSConfig-Befehle müssen von einer erhöhten Eingabeaufforderung aus ausgeführt werden, auch wenn der ausführende Benutzer über Administrationsrechte verfügt. Um eine Eingabeaufforderung mit erhöhten Rechten zu öffnen, klicken Sie auf "Start", klicken Sie mit der rechten Maustaste auf die Eingabeaufforderung, und klicken Sie dann auf "Als Administrator ausführen". Weitere Informationen finden Sie unter: Benutzerkontensteuerung.

Sie können administrative Aktionen auch interaktiv mithilfe der Verwaltungskonsole für Azure DevOps Server ausführen. Siehe Kurzübersicht zu administrativen Aufgaben.

Befehle auflisten und Hilfe abrufen

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

TFSConfig help

Um Hilfe für einen einzelnen Befehl zu erhalten, verwenden Sie den Hilfebefehl , und geben Sie den Namen des Befehls an, mit dem Sie Hilfe benötigen. So erhalten Sie z. B. Hilfe für den Befehl "Konten ":

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
Passwort aktualisieren	Ändert das Kennwort eines Kontos, das als Dienstkonto verwendet wird. Ändert das vorhandene Konto und alle Kontotypen, die als angegebenes Konto ausgeführt werden.
Veränderung	Ä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 so fest, dass er verwendet wird. 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 nur das neue Konto zu den erforderlichen Ressourcen hinzu. Nützlich für NLB-Szenarien. Verwenden Sie das Flag "Weiter", wenn einige Auflistungen nicht erreichbar sind. "Hinzufügen" kann später erneut ausgeführt werden, um alle verpassten Sammlungen zu aktualisieren. Fügt den Gruppen ein Konto hinzu, die für die Verwendung des Kontos als Dienstkonto erforderlich sind.
Garnitur	Legt den Dienst nur so fest, dass ein Konto verwendet wird, das den Ressourcen bereits hinzugefügt wurde. Nützlich für NLB-Szenarien.
Löschen	Entfernt das Konto aus allen Ressourcen. Man sollte beim Löschen eines Kontos Vorsicht walten lassen, da es dazu führen kann, dass anderen Servern der Dienst verweigert wird.
ResetOwner	Wenn die Datenbanken als Teil einer Verschiebung, eines Klons oder einer Notfallwiederherstellung wiederhergestellt werden, kann der Datenbankbesitzer zum Administrator wechseln, der den Server wiederhergestellt. Diese Option durchläuft alle Datenbanken und weist den dbo-Login dem aktuellen Besitzer zu.

Kontotyp	BESCHREIBUNG
AdminConsole	Benutzer der Verwaltungskonsole sind Benutzer, denen die Mindestberechtigungen für verschiedene Ressourcen erteilt wurden, um die Konsole zu verwenden.
Applikationsebene	Ändert das Dienstkonto im appPool für die Kernwebdienste. (TFSService)
Stellvertreter	Ändert das Dienstkonto im appPool für die Proxywebdienste. (TFSProxy)
BerichtsDatenquelle	Ändert das Konto, mit dem die Berichte auf die Berichtsdaten zugreifen. (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 bei Notfallwiederherstellungsszenarien hilfreich, in denen ein anderes Konto erforderlich ist, bevor der AT Only-Konfigurations-Assistent ausgeführt wird.

Die Option "Weiter" wird beim Hinzufügen oder Ändern eines Kontos verwendet. Bei diesen Vorgängen wird das Konto in jeder Sammlungsdatenbank geändert. Wenn "continue" angegeben ist, wird der Vorgang fortgesetzt, wenn eine Sammlung nicht erreichbar ist. Es 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 Authority\Network Service") 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, z. B. "/AccountType:ApplicationTier".
Passwort	Gibt das Kennwort des Dienstkontos an. Dieser Parameter ist optional, wenn Sie ein Systemkonto oder ein Konto verwenden, das nicht über ein Kennwort verfügt, z. B. Netzwerkdienst.
sqlInstance	Wird nur bei /ResetOwner verwendet. Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, und den Namen der Instanz, wenn Sie eine andere Instanz als die Standardinstanz verwenden möchten. Sie müssen den Namen und die Instanz im folgenden Format angeben: ServerName\InstanceName.
Datenbankname	Wird nur bei /ResetOwner verwendet. Gibt den Namen der Datenbank an, deren Besitz Sie ändern möchten. Mit diesem Befehl setzen Sie den Besitz der Datenbank zurück, die Sie auf das Konto festlegen, unter dem Sie den Befehl ausführen.
fortfahren	Aktualisiert alle Gruppen, die beim Ausführen des Befehls nicht verfügbar sind. Diese Option wird in der Regel in NLB-Szenarien verwendet.

Voraussetzungen

Um den Befehl "Konten " zu verwenden, müssen Sie Mitglied von:

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

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

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

Bemerkungen

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 die Berechtigung "Sensitiv und kann nicht delegiert werden" auf dem Anwendungsebenenserver haben. Weitere Informationen finden Sie auf dieser Seite auf der Microsoft-Website: Aktivieren der delegierten Authentifizierung.

Der Befehl "Konten " 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 von Datenquellen für Reporting Services in ein neues Konto in der Domäne Contoso, Contoso\NewAccount, und das Kennwort in Password.

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

Fügen Sie das Netzwerkdienst-Systemkonto den Dienstkontogruppen für Azure DevOps Server hinzu (Systemkonten verfügen nicht über 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 in der TeamDatabases benannten Instanz 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

---

ProjektberichteHinzufügen

Hinweis

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

Mit dem Befehl "addProjectReports " können Sie Berichte für ein vorhandenes Teamprojekt hinzufügen oder überschreiben.

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

Auswahlmöglichkeit	BESCHREIBUNG
Sammlung	Erforderlich. URL der Teamprojektsammlung.
Teamprojekt	Erforderlich. Gibt den Namen des Teamprojekts an.
Schablone	Erforderlich. Gibt den Namen der Prozessvorlage an. Verfügbare Optionen sind Agile, CMMI und Scrum.
Kraft	Wahlfrei. Gibt an, dass Berichte überschrieben werden sollen, wenn sie bereits vorhanden sind.

Voraussetzungen

Um den Befehl "addProjectReports " zu verwenden, müssen Sie über berechtigungen zum Ausführen von TFSConfig und zum Hochladen von Berichten in den Reporting Service verfügen.

Bemerkungen

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

Möglicherweise müssen Sie diesen Befehl verwenden, wenn:

• Das Projekt wurde im Azure DevOps-Portal erstellt und nicht aus Visual Studio
• Das Projekt wurde aus 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 über angepasste Berichte verfügen, erstellen Sie bitte 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

Das folgende Beispiel zeigt, wie Agile-Berichte zum 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]

Auswahl

Beschreibung

/viewAll

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

/provider: { NTLM | Aushandeln }

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 zu verwenden, müssen Sie mitglied der Sicherheitsgruppe "Azure DevOps-Administratoren" und einen lokalen Administrator auf dem Anwendungsserver oder Proxyserver sein, abhängig vom Wert der SiteType-Option .

Bemerkungen

Der Befehl " Authentifizierung " 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, die eine Änderung des Netzwerkauthentifizierungsprotokolls erfordern. Der Befehl ändert die NTAuthenticationProviders-Eigenschaft in der IIS-Metabasis.

Bevor Sie den Authentifizierungsbefehl verwenden, um das Authentifizierungsprotokoll zu ändern, können Sie den Befehl mit der Option "/viewAll " ausführen, um zu sehen, was die vorhandenen Einstellungen sind.

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, secure Sockets Layer (SSL) und Zertifikate verwendet.

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

Auswahlmöglichkeit	BESCHREIBUNG
Maschine	Gibt an, dass die Zertifikatliste nicht aus dem aktuellen Benutzerkontext, sondern aus dem lokalen Computerkontext stammt.
deaktivieren	Gibt an, dass die Clientauthentifizierungszertifikateinstellung deaktiviert wird.
Automatische Auswahl	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.
Daumenabdrücke	Gibt an, dass das Zertifikat, das dem angegebenen Fingerabdruck entspricht, verwendet wird. Sie können mehrere Zertifikate angeben, indem Sie einzelne Fingerabdrucke durch ein Komma trennen.

Voraussetzungen

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

Bemerkungen

Standardmäßig wählt der Befehl " Zertifikate " 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 zuerst die Server in Ihrer Bereitstellung von Azure DevOps Server für die Verwendung von Zertifikaten konfigurieren. 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, aus dem Sie den Befehl ausführen.

Beispiele

Das folgende Beispiel zeigt, wie Sie das Zertifikat des lokalen Computers angeben, das den Fingerabdruck aa bb cc dd ee ohne Aufforderung enthält.

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

Das folgende Beispiel zeigt, wie Sie mithilfe der automatischen Auswahl eines Clientzertifikats aus dem aktuellen Benutzerstore eine Angabe machen.

TfsConfig certificates /autoselect

---

ServerIDÄndern

Der Befehl changeServerID ändert die GUIDs, 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 dieselbe GUID aufweist, 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 folgenden Umständen verwenden:

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

• Sie möchten ein Softwareupdate oder eine Hardwarekonfiguration für eine doppelte Bereitstellung testen, sodass Sie keine Unterbrechung Ihrer Produktionsumgebung riskieren.

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

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

Hinweis

Der Befehl changeServerID ist nicht umkehrbar. Nachdem eine GUID geändert wurde, können Sie diese Änderung nicht rückgängigmachen, außer durch Wiederherstellen einer früheren Version dieser Datenbank.

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

Auswahlmöglichkeit	BESCHREIBUNG
sqlInstance	Erforderlich. Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, und den Namen der Instanz, wenn Sie eine andere Instanz als die Standardinstanz verwenden möchten. Wenn Sie eine Instanz angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
Datenbankname	Erforderlich. Gibt den Namen der Konfigurationsdatenbank für Azure DevOps Server an. Standardmäßig ist der Name dieser Datenbank TFS_ConfigurationDB.
nurProjektSammlungen	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.
Sammlungsname	Gibt an, eine neue Instanz-ID für die bestimmte Auflistung, aber nicht für die Azure DevOps-Instanz und die anderen Auflistungen zu erstellen.

Voraussetzungen

Um den Befehl changeServerID zu verwenden, müssen Sie Mitglied der Sicherheitsgruppe "Azure DevOps-Administratoren" und ein 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.

Bemerkungen

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 leiten, um eine Verbindung mit dem geänderten Server herzustellen, bevor er verwendet werden kann.

Beispiel

Das folgende Beispiel zeigt, wie Sie die GUIDs aller Datenbanken in der Contoso1-Bereitstellung von Azure DevOps Server ändern, wobei die Konfigurationsdatenbank auf dem Server mit dem Namen ContosoMain in der benannten Instanz TeamDatabases in SQL Server liegt.

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

---

Codeindex

Verwenden Sie den CodeIndex-Befehl zum Verwalten der Codeindizierung auf Azure DevOps Server. Sie können z. B. den Index zurücksetzen, um CodeLens-Informationen zu beheben, oder die Indizierung deaktivieren, um Serverleistungsprobleme 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>]

Auswahlmöglichkeit	BESCHREIBUNG
Indexierungsstatus	Zeigt den Status und die Konfiguration des Codeindizierungsdiensts an.
Indexierung festlegen	on: Beginnen Sie mit der Indizierung aller Changesets. off: Beenden der Indizierung aller Changesets. keepupOnly: Beenden Sie die Indizierung zuvor erstellter Changesets, und beginnen Sie nur mit der Indizierung neuer Changesets.
ignoreList	Gibt eine Liste der Codedateien und deren Pfade an, die nicht indiziert werden sollen. Hinzufügen: Füge die Datei zur Liste der ignorierten Dateien hinzu, die du nicht indizieren möchtest. entfernen: Entfernen Sie die Datei, die Sie indizieren möchten, aus der Liste der ignorierten Dateien. removeAll: Löschen Sie die ignorierte Dateiliste, und beginnen Sie mit der Indizierung aller Dateien. ansicht: Alle Dateien anzeigen, die nicht indiziert werden. ServerPath: Gibt den Pfad zu einer Codedatei an. Sie können das Platzhalterzeichen (*) am Anfang, Ende oder beide Enden des Serverpfads verwenden.
ListeGrosseDateien	Zeigt die angegebene Anzahl von Dateien an, die die angegebene Größe in KB überschreiten. Anschließend können Sie die Option "/ignoreList " verwenden, um diese Dateien von der Indizierung auszuschließen. Dazu benötigen Sie Team Foundation Server 2013 mit Update 3.
alle neu indexieren	Löschen Sie zuvor indizierte Daten, und starten Sie die Indizierung neu.
CodeIndexZerstören	Löschen Sie den Codeindex, und entfernen Sie alle indizierten Daten. Erfordert keine Bestätigung, wenn Sie die Option "/noPrompt " verwenden.
vorübergehendesDatenmengenLimit	Steuern Sie, wie viele temporäre Daten codeLens beim Verarbeiten von Changesets erstellt. Der Standardgrenzwert beträgt 6 GB (2 GB in Update 5). Ansicht: Anzeigen des aktuellen Größenlimits. SizeInGBs: Ändern Sie den Größengrenzwert. deaktivieren: Größenbegrenzung entfernen. Dieser Grenzwert wird überprüft, bevor CodeLens ein neues Changeset verarbeitet. Wenn temporäre Daten diesen Grenzwert überschreiten, hält CodeLens die Verarbeitung vergangener Änderungen und nicht neuer Änderungen an. CodeLens startet die Verarbeitung neu, nachdem die Daten bereinigt wurden und unter diesen Grenzwert fallen. Die Bereinigung wird automatisch einmal pro Tag ausgeführt. Dies bedeutet, dass temporäre Daten diesen Grenzwert überschreiten können, bis die Bereinigung gestartet wird. Dazu benötigen Sie Team Foundation Server 2013 mit Update 4.
Index-Verlauf-Periode	Steuern Sie, wie lange Ihr Änderungsverlauf indiziert werden soll. Dies beeinflusst, wie viel Verlauf CodeLens Ihnen anzeigt. Der Standardgrenzwert beträgt 12 Monate. Dies bedeutet, dass CodeLens ihren Änderungsverlauf nur aus den letzten 12 Monaten anzeigt. Ansicht: Zeigt die aktuelle Anzahl von Monaten an. all: Indexiere den gesamten Änderungsverlauf. 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.
Sammlungsname	Gibt den Namen der Projektauflistung an, für die der CodeIndex-Befehl ausgeführt werden soll. Erforderlich, wenn Sie "/CollectionId" nicht verwenden.
Sammlungs-ID	Gibt die Identifikationsnummer der Projektauflistung an, für die der CodeIndex-Befehl ausgeführt werden soll. Erforderlich, wenn Sie "/CollectionName" nicht verwenden

Voraussetzungen

Um den CodeIndex-Befehl zu verwenden, müssen Sie Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren sein. Siehe Berechtigungsreferenz für Azure DevOps Server.

Beispiele

Um den Codeindizierungsstatus und die Konfiguration anzuzeigen:

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

So beginnen Sie mit der Indizierung aller Changesets:

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

So beenden Sie die Indizierung zuvor erstellter Changesets, und beginnen Sie nur mit der Indizierung neuer Changesets:

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

So suchen 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 sie der ignorierten Dateiliste hinzu:

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

So zeigen Sie alle Dateien an, die nicht indiziert sind:

TfsConfig codeIndex /ignoreList:view

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

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

Um den gesamten Änderungssatzverlauf zu speichern:

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

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

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

So löschen Sie den Codeindex nach 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 den Sammlungsbefehl auch verwenden, um die Datenbank einer vorhandenen Sammlung zu duplizieren, sie umzubenennen und an die Bereitstellung anzufügen. Dieser Vorgang wird manchmal als Klonen einer Sammlung bezeichnet.

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

Auswahlmöglichkeit	BESCHREIBUNG
befestigen	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 zu Ihrer Bereitstellung von Azure DevOps Server hinzugefügt.
schaffen	Erstellt eine Sammlung.
abtrennen	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 "/trennen " verwenden, wird die Datenbank für die angegebene Sammlung 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 Sammlung beendet, und die Sammlung wird dauerhaft von Azure DevOps Server getrennt. Sie können die Sammlungsdatenbank nicht erneut an diese oder eine andere Bereitstellung anfügen.
SammlungsName	Gibt den Namen der Projektauflistung an. Wenn der Name der Auflistung Leerzeichen enthält, müssen Sie den Namen in Anführungszeichen setzen (z. B. "Meine Sammlung"). Entweder erforderlich, wenn /detach oder /delete verwendet wird. Wenn Sie diese Option mit /detach oder /delete verwenden, gibt sie die Auflistung an, die getrennt oder gelöscht wird. Wenn Sie diese Option mit "/attach" verwenden, gibt sie einen neuen Namen für die Auflistung an. Wenn Sie diese Option sowohl mit "/attach" als auch mit "/clone" verwenden, gibt sie den Namen für die duplizierte Auflistung an.
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 Auflistungsdatenbank, die auf diesem Server gehostet wird.
Servername	Gibt den Namen des Servers an, der die Konfigurationsdatenbank für Azure DevOps Server hostt, und den Namen der Instanz, wenn Sie eine andere Instanz als die Standardinstanz verwenden möchten. Wenn Sie eine Instanz angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
Datenbankname	Gibt den Namen der Konfigurationsdatenbank an. Standardmäßig ist der Name dieser Datenbank TFS_ConfigurationDB.
Klon	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 in erster Linie als Teil der Aufteilung einer Projektsammlung verwendet.

Tipp

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

Voraussetzungen

Um den Befehl "Sammlungen " zu verwenden, müssen Sie Mitglied der Sicherheitsgruppe "Team Foundation-Administratoren" sowie die lokale Gruppe "Administratoren" auf dem Computer sein, auf dem TfsConfig ausgeführt wird. Sie müssen auch Mitglied der Sysadmin-Sicherheitsrolle 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.

Bemerkungen

Um Sammlungen interaktiv zu verwalten oder eine Sammlung zu erstellen, können Sie den Knoten "Project Collections" in der Verwaltungskonsole für Azure DevOps verwenden. Siehe Projektsammlungen verwalten.

Beispiele

Das folgende Beispiel zeigt, wie Die Contoso Summer Intern Projects Projektsammlung dauerhaft aus einer Bereitstellung von Azure DevOps Server entfernt wird.

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.

Das folgende Beispiel zeigt, wie Sie die Contoso Summer Interns Projects Projektauflistung duplizieren, sie Contoso Winter Interns Projectsbenennen und die duplizierte 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

---

Spaltenstore-Index

Hinweis

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

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

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

Auswahlmöglichkeit	BESCHREIBUNG
aktiviert	Gibt an, ob Sie den Spaltenspeicherindex für die angegebene SQL-Instanz 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 der Instanz, wenn eine andere Instanz als die Standardeinstellung verwendet wird. Wenn Sie eine Instanz angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
Datenbankname	Gibt den Namen der Datenbank an, für die der Spaltenspeicherindex aktiviert oder deaktiviert wird.

Voraussetzungen

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

Bemerkungen

Sie würden in der Regel den Befehl columnStoreIndex verwenden, wenn Sie eine Datenbank von einer SQL-Instanz verschieben, die den Spaltenspeicherindex unterstützt, zu einer, die diesen nicht unterstützt. In diesem Fall müssen Sie alle Spaltenspeicherindizes deaktivieren, bevor Sie die Datenbanken erfolgreich verschieben konnten. Wenn Sie eine Datenbank zurück zu einer SQL-Instanz verschieben, die den Spaltenspeicherindex unterstützt, möchten 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 mit dem Namen TFS_DefaultCollection aktivieren, die auf einer benannten Instanz ContosoMain auf einem Server mit dem Namen TeamDatabases auf einer SQL-Instanz ausgeführt wird.

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

---

Mail konfigurieren

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

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

Auswahlmöglichkeit	BESCHREIBUNG
Absender-E-Mail-Adresse	Gibt die Adresse an, von der E-Mail-Benachrichtigungen von Azure DevOps Server für eine Überprüfung, eine Arbeitsaufgabe, die Ihnen zugewiesen wurde, 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 ist 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 zu verwenden, 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

Bemerkungen

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 zum Konfigurieren der Absender-E-Mail-Adresse auf TFS@contoso.com und des SMTP-Mailservers auf ContosoMailServer verwendet wird.

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

---

DB-Komprimierung

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

Auswahlmöglichkeit	BESCHREIBUNG
Seitenkomprimierung	Gibt an, ob Sie die Seitenkomprimierung für die angegebene SQL-Instanz 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 Instanz, wenn eine andere Instanz als die Standardeinstellung verwendet wird. Wenn Sie eine Instanz angeben, müssen Sie das Format verwenden: ServerName\InstanceName
Datenbankname	Gibt den Namen der Datenbank an, für die die Seitenkomprimierung aktiviert oder deaktiviert wird.
jetzt neu aufbauen	Wahlfrei. Gibt an, ob Datenbankindizes sofort neu erstellt (und komprimiert oder dekomprimiert) werden sollen. Wenn sie nicht verwendet werden, werden Indizes von einem Hintergrundauftrag neu erstellt, der wöchentlich ausgeführt wird.
Offline	Wahlfrei. 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, ist jedoch möglicherweise schneller als ein Online-Indexneuaufbau.

Voraussetzungen

Um den Befehl "dbCompression " zu verwenden, müssen Sie Mitglied der Sysadmin-Rolle für die angegebene SQL Server-Instanz sein.

Bemerkungen

Sie würden in der Regel den Befehl "dbCompression " verwenden, wenn Sie eine Datenbank aus einer SQL-Instanz verschieben würden, die die Komprimierung zu einer unterstützten, die nicht unterstützt wurde. In diesem Fall müssen Sie die Komprimierung deaktivieren und alle Indizes dekomprimieren, bevor Sie die Datenbanken erfolgreich verschieben konnten. Ebenso möchten Sie, wenn Sie eine Datenbank zurück zu einer SQL-Instanz verschieben, die die Komprimierung unterstützt, möglicherweise erneut komprimieren, um Speicherplatz zu sparen.

Dieser Befehl ändert nur, ob Azure DevOps Server die Datenbankseitenkomprimierung verwendet oder nicht – Ihre Datenbanken müssen weiterhin in einer SQL-Instanz gehostet werden, deren Edition die Komprimierung unterstützt. Weitere Informationen finden Sie unter Features, die von den Editionen von SQL Server unterstützt werden.

Beispiel

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

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

---

TestErgebnisseLöschen

Sie verwenden den Befehl deleteTestResults , um alte gespeicherte Testergebnisse aus Ihrem Sammlungsspeicher zu löschen. Dies geschieht in der Regel, um die Größe des Speichers zu verringern oder die Zeit zu verringern, die beim Migrieren von Testergebnissen zu einem neuen Schema erforderlich ist.

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

Auswahlmöglichkeit	BESCHREIBUNG
AlterInTagen	Testergebnisse, die älter als die angegebene Anzahl von Tagen sind, werden gelöscht oder in der Vorschau angezeigt.
sqlInstance	Der Name des Servers, auf dem die Datenbank gehostet wird, für die Testergebnisse gelöscht oder in der Vorschau angezeigt werden, und den Namen der Instanz, wenn eine andere Instanz als die Standardeinstellung verwendet wird. Wenn Sie eine Instanz angeben, müssen Sie das Format verwenden: ServerName\InstanceName.
Datenbankname	Der Name der Datenbank, für die Testergebnisse gelöscht oder in der Vorschau angezeigt werden.
Typ	Wahlfrei. Der Typ der zu löschenden Testergebnisse. Gültige Werte sind automatisiert, manuell und alle.
Vorschau	Wahlfrei. Zeigen Sie die Anzahl der Testergebnisse an, die basierend auf dem Alter in Tagen gelöscht würden, jedoch nicht gelöscht werden sollen.

Voraussetzungen

Um den Befehl deleteTestResults zu verwenden, müssen Sie Mitglied der Sysadmin-Rolle für die angegebene SQL Server-Instanz sein.

Bemerkungen

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

Beispiel

Das folgende Beispiel zeigt, wie manuelle Testergebnisse gelöscht werden, die älter als 60 Tage sind, für eine Datenbank TFS_DefaultCollection, die sich auf einer SQL-Instanz ContosoMain befindet und auf einem Server TeamDatabases in der benannten Instanz ausgeführt wird.

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

---

DeploymentPool

Der DeploymentPool-Befehl dient zum Migrieren aller Bereitstellungsgruppen von einem Bereitstellungspool zu einem anderen.

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

Auswahlmöglichkeit	BESCHREIBUNG
fromPool	Name des Quellpools.
toPool	Zielpoolname.

---

Identitäten

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

• Ändern der Domäne Ihres Deployments

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

• Migrieren von Konten über Domänen hinweg 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>]

Auswahlmöglichkeit	BESCHREIBUNG
Ändern	Gibt an, dass Sie Identitäten ändern möchten, anstatt sie aufzulisten.
fromdomain	Erforderlich bei Verwendung von /change. Gibt die ursprüngliche Domäne der Identitäten an, die Sie ändern möchten. Wenn Sie von einer Arbeitsgruppenumgebung wechseln, geben Sie den Namen des Computers an.
todomain	Erforderlich bei Verwendung von /change. Gibt die Domäne an, zu der Sie die Identität ändern möchten. Wenn Sie zu einer Arbeitsgruppenumgebung wechseln, geben Sie den Namen des Computers an.
Konto	Gibt den Namen eines Kontos an, für das Sie Identitäten auflisten oder ändern möchten.
berücksichtigen	Gibt den Namen eines Kontos an, zu dem Sie die Identität wechseln möchten.
SQLInstance	Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, und den Namen der Instanz, wenn Sie eine andere Instanz als die Standardinstanz verwenden möchten. Wenn Sie eine Instanz angeben, müssen Sie das folgende Format verwenden: ServerName\InstanceName
Datenbankname	Gibt den Namen der Konfigurationsdatenbank für Azure DevOps Server an.

Voraussetzungen

Um den Befehl " Identitäten " zu verwenden, müssen Sie Mitglied der Sicherheitsgruppe "Team Foundation-Administratoren" und ein 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.

Bemerkungen

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

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

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

Beispiele

Das folgende Beispiel zeigt, wie sie die Namen aller Windows-Benutzer und -Gruppen auflisten, die in Azure DevOps Server gespeichert sind, und zeigt an, ob die SID für jeden Benutzer oder jede Gruppe der SID in Windows entspricht. Die Domänenadministratoren von Contoso1 haben Domänengruppen wie z. B. Contoso1\\Developers und Contoso1\\Testers erstellt, um die Verwaltung von Berechtigungen in 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 Sie die SIDs für alle Konten in Azure DevOps Server von der Domäne Contoso1 in die SIDs für Konten ändern, die übereinstimmende Namen in der ContosoPrime Domäne haben. Nur Kontonamen, die übereinstimmen, werden ihre SIDs aktualisiert. Wenn das hholt-Konto beispielsweise als Contoso1\hholt und ContosoPrime\hholt existiert, wird die Konto-SID in die SID für ContosoPrime\hholt geändert. Wenn das ContosoPrime\hholt Konto nicht vorhanden ist, wird die SID nicht aktualisiert für Contoso1\hholt.

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

Das folgende Beispiel zeigt, wie Sie das Konto eines einzelnen Benutzers, Contoso1\hholt, in das Konto eines anderen Benutzers, ContosoPrime\jpeoples, ändern.

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

Das folgende Beispiel zeigt, wie Sie die SID des NT AUTHORITY\NETWORK SERVICE-Dienstkontos ändern, das bei der Bereitstellung von Azure DevOps Server verwendet wird, wenn die Domäne der Bereitstellung von Contoso1 zu ContosoPrime geändert wird. Um ein Systemkonto wie z. B. Netzwerkdienst zu ändern, müssen Sie einem zweistufigen Prozess folgen. Zuerst ändern Sie das Dienstkonto von NT AUTHORITY\NETWORK SERVICE zu einem Domänenkonto in der neuen Domäne TempSVC, und anschließend ändern Sie das Konto auf dem Server in der neuen Domäne wieder zu NETWORK SERVICE. Die Konfigurationsdatenbank wird auf dem Server gehostet, der den Namen ContosoMain trägt, bei der benannten Instanz 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"

---

Arbeitsplätze

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 bereitstellt, oder einen Auftrag für eine oder alle Projektsammlungen wiederholen.

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

Auswahlmöglichkeit	BESCHREIBUNG
wiederholen	Erforderlich, wenn /dumplog nicht verwendet wird. Gibt an, dass der letzte Auftrag für die angegebene Projektkollektion erneut versucht 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 aktuellste 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.
SammlungsName	Erforderlich, wenn /CollectionID nicht verwendet wird. Gibt den Namen der Auflistung an, für die der letzte Auftrag entweder wiederholt (/wiederholen) oder protokolliert (/dumplog) wird. Wenn Sie alle Auflistungen angeben möchten, können Sie ein Sternchen (*) verwenden.
Sammlungs-ID	Erforderlich, wenn /CollectionName nicht verwendet wird. Gibt die Identifikationsnummer der Auflistung an, für die der letzte Auftrag entweder wiederholt (/wiederholen) oder protokolliert (/dumplog) wird.

Voraussetzungen

Um den Befehl "Aufträge " zu verwenden, müssen Sie Mitglied der Sicherheitsgruppe "Azure DevOps-Administratoren" sein. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Bemerkungen

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 auswählen 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"

---

Offline-Trennung

Sie verwenden den Befehl "offlineDetach", um eine Offlinesammlungsdatenbank zu einer getrennten Offlinesammlungsdatenbank zu machen.

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

Auswahlmöglichkeit	BESCHREIBUNG
configurationDB	Gibt den Namen der zu verwendenden Konfigurationsdatenbank an.
collectionDB	Gibt den Namen der Sammlungsdatenbank an, die getrennt werden soll.

Voraussetzungen

So verwenden Sie den Befehl "offlineDetach"

• Sie müssen Mitglied der Sysadmin-Rolle für die angegebene SQL Server-Instanz sein.
• Die Version des TFSConfig-Tools muss mit der Version der Azure DevOps Server-Datenbank übereinstimmen.

Bemerkungen

Dieser Befehl ändert das Schema der angegebenen Sammlungsdatenbank und sollte niemals für Datenbanken ausgeführt werden, die von einer Azure DevOps Server-Bereitstellung verwendet werden. Wenn Ihre Datenbanken von einer Azure DevOps 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. Zuvor war die Wiederherstellung eines vollständigen und konsistenten Satzes von Datenbanken (Konfiguration und aller Sammlungen) in einer Stagingumgebung erforderlich, das Konfigurieren einer Azure DevOps Server-Bereitstellung mithilfe dieser Datenbanken und das Trennen der betreffenden Sammlung von Interesse.

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

Beispiel

Das folgende Beispiel veranschaulicht das Trennen einer Sammlungsdatenbank mit dem Namen TFS_PrimaryCollection und einer Konfigurationsdatenbank mit dem Namen TFS_Configuration, wobei beide auf einer SQL-Instanz ausgeführt werden, die auf einem Server mit dem Namen ContosoTemp der benannten Instanz Backups läuft.

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

---

Stellvertreter

Sie können den Proxybefehl verwenden, um die von Azure DevOps Proxy Server verwendeten Einstellungen zu aktualisieren oder zu ändern. Azure DevOps Proxy Server bietet Unterstützung für verteilte Teams zur Verwendung der Versionssteuerung durch Verwalten eines Caches der heruntergeladenen Versionssteuerungsdateien am Speicherort des verteilten Teams. Durch die Konfiguration von Azure DevOps Proxy Server können Sie die bandbreitenübergreifend benötigte Bandbreite erheblich reduzieren. Darüber hinaus müssen Sie das Herunterladen und Zwischenspeichern von Versionsdateien nicht verwalten; Die Verwaltung der Dateien ist für den Entwickler transparent, der die Dateien verwendet. In der Zwischenzeit werden alle Metadatenaustausche und Dateiuploads weiterhin in Azure DevOps Server angezeigt. Wenn Sie 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 einige der von diesem Dienst verwendeten Einstellungen zu verwalten.

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

siehe Vorgehensweise: Installation des Azure DevOps-Proxyservers und einrichten eines Remotestandorts. Weitere Informationen zum Konfigurieren von Proxy auf Clientcomputern finden Sie unter Azure DevOps Version Control Command Reference.

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

Auswahlmöglichkeit	BESCHREIBUNG
hinzufügen	Fügt der Proxyliste in der datei Proxy.config den angegebenen Server oder die angegebene Auflistung hinzu. Sie können /add mehrmals ausführen, um weitere Sammlungen oder Server einzuschließen. Wenn Sie /add mit einer sammlung verwenden, die in Azure DevOps Services gehostet wird, werden Sie aufgefordert, Ihre Anmeldeinformationen für Azure DevOps Services einzugeben.
Ä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 Sammlung aus der Proxyliste in der Proxy.config Datei.
Konto	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, lautet "Kontodienst".
fortfahren	Setzt die Ausführung des Befehls fort, auch wenn der Überprüfungsprozess Warnungen erzeugt.
Sammlung	Gibt die URL der Projektauflistung an, die in Azure DevOps Services im AccountName.DomainName/CollectionName Format gehostet wird.
Konto	Gibt den Namen des Kontos an, das als Dienstkonto für Azure DevOps Services verwendet wird. Wenn der Kontoname Leerzeichen enthält, muss der Name in Anführungszeichen gesetzt werden (""). Alle Sonderzeichen in Kontonamen müssen gemäß der Befehlszeilensyntax angegeben werden.
Konto	Gibt die URL einer Azure DevOps Server-Bereitstellung im ServerURL:Port/tfs Format an.
DateiFürPersönlicherZugangsschlüssel	Gibt optional den Pfad zu einer Datei an, die ein persönliches Zugriffstoken enthält. Dieses Token wird verwendet, um sich bei der Sammlung oder dem Konto zu authentifizieren, während ein Proxy registriert wird. (In TFS 2018 Update 1 hinzugefügt)
Eingänge	Wahlfrei. Gibt zusätzliche Einstellungen und Werte an, die beim Konfigurieren des Proxys verwendet werden sollen.! Beispielsweise können Werte für GvfsProjectName und GvfsRepositoryName können verwendet werden, um ein Git-Repository für die Verwendung mit Git Virtual File System (GVFS) zu konfigurieren (hinzugefügt in TFS 2018 Update 1)

Voraussetzungen

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

Bemerkungen

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

Beispiele

Das folgende Beispiel zeigt, wie Sie der Proxyliste eine Azure DevOps Server-Bereitstellung FABRIKAM hinzufügen.

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

Das folgende Beispiel zeigt, wie Sie der Proxyliste mithilfe eines persönlichen Zugriffstokens eine in Azure DevOps Services gehostete Projektsammlung hinzufügen. Dieses Token wird nur zum Registrieren des Proxys mit dem Azure DevOps Services-Konto verwendet . 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 Projektauflistung 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 vom Proxy für die projektsammlung verwendete Dienstkonto ändern, das in Azure DevOps Services gehostet wird. Die Sammlung heißt PhoneSaver, der Kontoname für Azure DevOps Services ist HelenaPetersen.fabrikam.com, und das vom Proxy verwendete Dienstkonto wird zu My Proxy Service Account geä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 für die 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]

Auswahlmöglichkeit	BESCHREIBUNG
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.
BerichtsdatenquellenPasswort	Erforderlich, wenn die TFS_Analysis-Datenbank 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 " zu verwenden, 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 Instanz von SQL Server ausgeführt wird, die die Datenbanken für Azure DevOps Server hosten

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

Bemerkungen

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

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

Beispiel

Das folgende Beispiel zeigt, wie Sie die Analysis Services-Datenbank für eine Bereitstellung von Azure DevOps Server neu erstellen.

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, auf dem die Konfigurationsdatenbank in Azure DevOps Server gehostet wird. Sie können diesen Befehl verwenden, wenn Sie die Konfigurationsdatenbank auf neue Hardware wiederherstellen oder wenn Sie die Domäne einer Bereitstellung ändern.

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

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

Voraussetzungen

Um den RegisterDB-Befehl zu verwenden, müssen Sie Mitglied der Azure DevOps-Administratorgruppe auf dem Anwendungsebenenserver für Azure DevOps und ein Mitglied der Sysadmin-Gruppe in SQL Server auf dem Datenebenenserver für Azure DevOps sein. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Bemerkungen

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

Damit der RegisterDB-Befehl erfolgreich ausgeführt werden kann, 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 zu einer Konfigurationsdatenbank umgeleitet, die sich auf dem Server ContosoMain in der SQL Server-Instanz TeamDatabasesbefindet.

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

---

NeumapDBs

Der Befehl "RemapDBs " leitet Azure DevOps Server zu seinen Datenbanken um, wenn sie auf mehreren Servern gespeichert sind und Sie die Konfiguration Ihrer Bereitstellung wiederherstellen, verschieben oder anderweitig ändern. Sie müssen z. B. Azure DevOps Server an alle Datenbanken für Projektsammlungen umleiten, wenn sie von der Konfigurationsdatenbank auf einem separaten Server oder auf separaten Servern gehostet werden. Sie müssen Azure DevOps Server auch 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 einer separaten Instanz von der Konfigurationsdatenbank gehostet werden.

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

Auswahlmöglichkeit	BESCHREIBUNG
Datenbankname	Gibt den Namen des Servers an, der die Datenbank hostt, die Sie 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 der Instanz, wenn Sie eine andere Instanz als die Standardinstanz verwenden möchten. Wenn Sie mehrere Server angeben, müssen Sie ein Komma verwenden, um mehrere Server- und Instanznamen zu trennen.
Analyseinstanz	Wahlfrei. Gibt den Namen des Servers und der Instanz an, der SQL Server Analysis Services hosten soll. Verwenden Sie diese Option, um den Server und die Instanz anzugeben, auf dem die Analysis Services-Datenbank gehostet wird.
AnalyseDatenbankName	Wahlfrei. 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.
Vorschau	Wahlfrei. Zeigt die Aktionen an, die Sie ausführen müssen, um die Konfiguration zu aktualisieren.
fortfahren	Wahlfrei. Gibt an, dass der Befehl "RemapDB " fortgesetzt werden soll, auch wenn beim Versuch, eine oder mehrere Datenbanken zu finden, ein Fehler auftritt. Wenn Sie die Option "/continue " verwenden, werden alle Sammlungen, deren Datenbanken nicht auf dem server oder auf den Servern gefunden werden, die Sie angeben, so konfiguriert, dass sie den Server und die Instanz verwendet, auf dem die Konfigurationsdatenbank gehostet wird.

Voraussetzungen

Um den Befehl "RemapDBs " zu verwenden, müssen Sie Mitglied der Sicherheitsgruppe "Azure DevOps-Administratoren" und ein 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.

Bemerkungen

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 zu ihrer Konfigurationsdatenbank TFS_Configurationumleiten. Diese Datenbank wird in ContosoMain der benannten Instanz TeamDatabasesgehostet. Die Projektsammlungsdatenbanken werden sowohl auf ContosoMain\TeamDatabases als auch auf der Standardinstanz Contoso2 gespeichert.

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

---

RepairJobQueue

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

TfsConfig repairJobQueue

Voraussetzungen

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

Bemerkungen

Normalerweise verwenden Sie den Befehl repairJobQueue , wenn Sie feststellen, dass geplante Aufträge nicht ausgeführt werden.
Der Befehl verwendet keine Argumente und erfordert die Konfiguration der Azure DevOps Server-Bereitstellung.

Beispiel

TfsConfig repairJobQueue

---

Einstellungen

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

Um diese URLs interaktiv zu ändern oder nur die aktuellen Einstellungen anzuzeigen, können Sie die Verwaltungskonsole für Azure DevOps verwenden. Siehe Kurzübersicht zu administrativen Aufgaben.

TfsConfig settings [/publicURL:URL]

Auswahlmöglichkeit	BESCHREIBUNG
öffentliche URL	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.

Bemerkungen

Der Einstellungsbefehl ändert 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

Das folgende Beispiel ändert den Wert von NotificationURL in http://contoso.example.com/tfs und den Wert von ServerURL in http://contoso.example.com:8080/tfs.

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

---

Konfiguration

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

Auswahl

Beschreibung

/uninstall

Gibt ein oder mehrere Features an, die vom Computer deinstalliert werden sollen, auf dem Sie den Befehl ausführen. Zu den Optionen gehören: "All", "ApplicationTier", "Search" und "VersionControlProxy".

Voraussetzungen

Um den Setupbefehl zu verwenden, 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 das Anwendungstier und die Build-Features vom derzeitigen Computer entfernt.

TfsConfig setup /uninstall:ApplicationTier 

---

TCM

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

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

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

Auswahl

Beschreibung

/upgradeTestPlans

Erforderlich, es sei denn, /upgradeStatus wird verwendet.

Konvertiert vorhandene Testpläne und Testsuiten, sodass sie auf die arbeitsgegenstandsbasierten Testpläne und Testsuiten verweisen. Außerdem werden vorhandene Testverwaltungsdaten und Verknüpfungen zwischen anderen vorhandenen Testartefakten wie Testpunkten, Testläufen und Testergebnissen aktualisiert.

/upgradeStatus

Erforderlich, es sei denn /upgradeTestPlans wird verwendet.

Meldet den Migrationsstatus der Testdaten für das angegebene Projekt. Außerdem wird angegeben, ob das angegebene Projekt Testpläne hat.

/CollectionName:CollectionName

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

Wenn im Namen der Projektsammlung 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 den Migrationsstatus überprüfen möchten. Dieses Projekt muss in der Auflistung definiert werden, die Sie mithilfe des Parameters "/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 Sicherheitsgruppe "Team Foundation-Administratoren" und ein Administrator auf dem Anwendungsebenenserver sein.

Siehe Festlegen von Administratorberechtigungen für Azure DevOps Server.

Bemerkungen

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

Bevor Sie den TCM-Befehl verwenden können, müssen Sie zuerst die Definition der Arbeitsaufgabe "Testplan" und die Testplankategorie in das Projekt importieren.

Weitere Informationen zur Migration und zum Einsatz 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 Toolsverzeichnis für Azure DevOps Server ausführen. Dieser Speicherort lautet standardmäßig: drive:\%programfiles%\TFS 12.0\Tools.

Sie verwenden den TCM-Befehl nur, wenn die automatische Migration vorhandener Testdaten fehlschlägt.

Weitere Informationen zur Migration und zum Einsatz dieses Befehls finden Sie in manuellen 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 den 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 wiederum ausführen.

Beispiele

Das folgende Beispiel zeigt, wie Sie den 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"

---

Unbeaufsichtigt

Befehlsverfügbarkeit: Azure DevOps Server 2019

Der Befehl " Unbeaufsichtigt" wurde für Benutzer entwickelt, die mit Azure DevOps Server und dem Konfigurationsprozess vertraut sind und die Azure DevOps Server auf verschiedenen Computern installieren müssen.

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

Verwenden Sie die /create-Option, um eine unbeaufsichtigte Datei 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 Installationsprozesses Eingaben bereitstellen zu müssen. Bei mehreren Installationen wird dadurch auch sichergestellt, dass die gleichen Konfigurationsparameter auf mehreren Servern verwendet werden.

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

Auswahlmöglichkeit	BESCHREIBUNG
schaffen	Erstellt die Unattend-Datei mit dem von Ihnen angegebenen Namen und Parametern.
konfigurieren	Konfiguriert Azure DevOps Server mithilfe der von Ihnen angegebenen unattend-Datei und der Parameter. Sie müssen "/type" oder "/unattendfile" mit dieser Option verwenden.
Typ	Gibt den Typ der zu verwendenden Konfiguration an. Wenn Sie /configure verwenden, sind entweder /type oder /unattendfile erforderlich, aber Sie können beide nicht verwenden.
Unbeaufsichtigte Datei	Gibt die zu erstellende oder zu verwendende Unbeaufsichtigte Datei an, je nachdem, ob der ursprüngliche Parameter "/create" oder "/configure" lautet. Wenn Sie /configure verwenden, ist entweder /unattendfile oder /type erforderlich.
Eingänge	Wahlfrei. Wenn Sie "/create" verwenden, werden Einstellungen und Werte angegeben, die beim Erstellen der Unattend-Datei verwendet werden sollen. Wenn Sie "/configure" verwenden, werden zusätzliche Einstellungen und Werte angegeben, die in Verbindung mit der nichtattierten Datei verwendet werden sollen. Als Alternative zur Verwendung von /inputs können Sie die Unattend-Datei manuell in einem beliebigen Texteditor bearbeiten. Dies ist für bestimmte Eingabetypen erforderlich, z. B. ServiceAccountPassword oder PersonalAccessToken, da diese geheimen Werte nicht mit dem Parameter "/input" festgelegt werden können.
überprüfen	Wahlfrei. Gibt eine Konfigurationsausführung an, die nur Überprüfungen auf Basis der Unattend-Datei, Eingaben und des Konfigurationstyps durchführt. Dies ist eine Alternative zum Ausführen einer vollständigen Konfiguration.
fortfahren	Wahlfrei. Gibt an, dass /create oder /configure unabhängig von Warnungen von Überprüfungen fortgesetzt werden soll.

Installationsart	BESCHREIBUNG
NewServerBasic	Konfiguriert die wesentlichen Entwicklungsdienste für Azure DevOps Server. Dazu gehören Quellcodeverwaltung, Arbeitsaufgaben, Build und optional Suche.
NewServerAdvanced	Konfiguriert die wesentlichen Entwicklungsdienste und ermöglicht die optionale Konfiguration der Integration in Reporting Services.
Aktualisierung	Aktualisiert Azure DevOps Server auf die aktuelle Version aus einer unterstützten vorherigen Version.
PreProductionUpgrade	Testen Sie das Upgrade auf einer vorhandenen Azure DevOps Server-Bereitstellung in einer Vorproduktionsumgebung. Dies erfolgt in der Regel mithilfe von Datenbanken, die aus Produktionssicherungen wiederhergestellt wurden. Dieses Szenario enthält 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 eine neue Anwendungsebene mit vorhandenen Einstellungen schnell ausführen. Wenn Sie die Möglichkeit haben möchten, vorhandene Einstellungen zu ändern, verwenden Sie stattdessen den Advanced ApplicationTierOnlyAdvanced-Typ.
NurAnwendungsstufeFortgeschritten	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 ApplicationTierOnlyBasic-Typ.
Klonen	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 enthält zusätzliche Schritte, um sicherzustellen, dass die neue Bereitstellung die Produktionsbereitstellung nicht beeinträchtigt.
Stellvertreter	Konfiguriert einen Versionssteuerungsproxydienst.

Voraussetzungen

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

• Je nach Installationstyp benötigen Sie möglicherweise auch zusätzliche Administratorberechtigungen.

Wenn Sie beispielsweise den Befehl " Unbeaufsichtigt " zum Installieren von Azure DevOps Server verwenden, müssen Sie Mitglied der Sysadmin-Gruppe in der Instanz von SQL Server sein, die Azure DevOps Server unterstützt. Weitere Informationen finden Sie im Abschnitt "Fragen und Antworten" von Hinzufügen von Administratoren auf Serverebene zu Azure DevOps Server.

Bemerkungen

Bevor Sie den Befehl " Unbeaufsichtigt" verwenden können, um Azure DevOps Server zu konfigurieren, müssen Sie die Dienstkonten erstellen , die Sie als Teil Ihrer Bereitstellung verwenden werden. Außerdem müssen Sie alle erforderlichen Software für den ausgewählten Installationstyp installieren. Dies schließt Azure DevOps Server selbst ein. Sie müssen Azure DevOps Server installieren, aber nicht konfigurieren, da der Befehl Unattend dies für Sie übernimmt.

Der Befehl "Unbeaufsichtigt" konfiguriert Azure DevOps Server-Komponenten. Die Erstinstallation der Software wird nicht ausgeführt. Sie konfiguriert die Software entsprechend Ihren Spezifikationen, nachdem die Bits auf dem Computer vorhanden sind.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Unattend-Datei für eine grundlegende Installation von Azure DevOps Server erstellen.

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

In diesem Beispiel wird die Unattend-Datei im selben Verzeichnis wie der Befehl erstellt. Eine Protokolldatei wird als Teil des Befehls erstellt, und der Speicherort der Datei wird im Befehl als Teil der 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 Unattend-Datei für die Konfiguration eines Azure DevOps Proxy Servers 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 PersonalAccessToken=PersonalAccessTokenValue erreicht werden.

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

Das folgende Beispiel zeigt, wie Sie eine unattend-Datei für die Konfiguration von Azure DevOps Server Build auf einem Server erstellen, wobei FabrikamFiber\BuildSVC als Builddienstkonto verwendet wird, und dann Azure DevOps Server Build mithilfe dieser unattend-Datei konfigurieren.

Wichtig

In diesem Beispiel bearbeitet der Administrator die Unattend-Datei nach dem Erstellen manuell, um das Kennwort für das Builddienstkonto anzugeben. Durch das Hinzufügen des Kennworts als Eingabe ServiceAccountPassword=PasswordPlaceholder; 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 die dem Controller DefaultCollectionzugeordnete Projektsammlung:

    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 Befehl ziplogs wurde entwickelt, um Protokolle zu sammeln und eine ZIP-Datei abzulegen ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

---