Freigeben über

Verwenden von TFSConfig zum verwalten von Azure DevOps lokal

  • Artikel

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 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 von einer Eingabeaufforderung mit erhöhten Rechten ausgeführt werden, auch wenn der ausgeführte Benutzer über administratorrechtliche Anmeldeinformationen 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 Schnellübersicht zu Verwaltungsaufgaben.

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 Help-Befehl , und geben Sie den Namen des Befehls an, für den Sie Hilfe benötigen. So erhalten Sie beispielsweise 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
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, erteilt die erforderlichen Berechtigungen und legt dann den Dienst so fest, dass es 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 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 andere Server den verweigerten Dienst erhalten.
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 möchte. Diese Option durchläuft alle Datenbanken und legt die dbo-Anmeldung auf den aktuellen Besitzer fest.
AccountType BESCHREIBUNG
AdminConsole Benutzer der Verwaltungskonsole 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 nur für AT ausgeführt wird.

Die Continue-Option wird beim Hinzufügen oder Ändern eines Kontos verwendet. Bei diesen Vorgängen wird das Konto in jeder Sammlungsdatenbank geändert. Wenn continue angegeben wird, wird sie fortgesetzt, wenn eine Sammlung nicht erreichbar ist. Es kann erneut ausgeführt werden, wenn sie erreichbar sind.

Hinweis

Die Konten müssen das Format domainName\userName aufweisen. Für Systemkonten müssen Sie Anführungszeichen um den vollständigen Kontonamen herum verwenden (z. B. "NT Authority\Network Service"). Systemkonten erfordern kein Kennwort.

Parameter BESCHREIBUNG
Konto Gibt den Namen des Kontos an, das Sie hinzufügen, ändern oder aus einem Kontotyp löschen möchten, auf das 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 des 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 konten 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 keine Konten erstellen.

Bevor Sie die Domäne oder Arbeitsgruppe eines Kontos ändern, muss das Konto über das Konto verfügen, das vertraulich ist und keine Berechtigung für den Anwendungsebenenserver delegiert werden kann. 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 der Datenquellen für Reporting Services in ein neues Konto in der Contoso-Domäne, Contoso\NewAccountund das 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 verfügen über 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 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 über angepasste Berichte verfügen, 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 Sie agile Berichte zum MyProject Projekt in der http://myTfsServer:8080/tfs/DefaultCollection Projektsammlung hinzufügen.

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

Authentifizierung

Der Authentifizierungsbefehl ändert das Netzwerkauthentifizierungsprotokoll, das die Azure DevOps Server Anwendungsebene oder Proxywebsite verwendet.

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

Option

Beschreibung

/viewAll

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

/provider: { NTLM | Verhandeln }

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

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

/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 ein Mitglied der Sicherheitsgruppe Azure DevOps-Administratoren und ein lokaler Administrator auf dem Anwendungsebenenserver oder Proxyserver sein, abhängig vom 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 lokalen Computerkontext 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 Fingerabdrücke 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, von dem aus Sie den Befehl ausführen. Weitere Informationen finden Sie unter Berechtigungsreferenz für Azure DevOps Server.

Hinweise

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 lokalen Computerkontext anzugeben.

Bevor Sie den Befehl zertifikate verwenden, müssen Sie zuerst 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 wurden. 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 Sie das Zertifikat des lokalen Computers angeben, das über den Fingerabdruck aa bb cc dd ee ohne Aufforderung verfügt.

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 Benutzerspeicher angeben.

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 mehrere Datenbanken über dieselbe GUID verfügen, 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 normalerweise 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 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 in einer doppelten Bereitstellung testen, um keine Unterbrechung der Produktionsumgebung zu 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 ist nicht umkehrbar. Nachdem eine GUID geändert wurde, können Sie diese Änderung nicht rückgängigmachen, außer indem 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 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 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, eine neue instance-ID für die bestimmte Sammlung, aber nicht für Azure DevOps instance und die anderen Sammlungen zu erstellen.

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 Sie die GUIDs aller Datenbanken in der Contoso1-Bereitstellung von Azure DevOps Server ändern, 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 auf 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 das Größenlimit.
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. Siehe Berechtigungsreferenz für Azure DevOps Server.

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 Auflistungsbefehl verwenden, um eine Projektsammlung aus einer Bereitstellung von Azure DevOps Server anzufügen, zu trennen oder zu löschen. Sie können den Auflistungsbefehl auch verwenden, um die Datenbank einer vorhandenen Sammlung zu duplizieren, umzubenennen und sie 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. Optional können Sie mit dieser Option auch /collectionName und /clone 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 Auflistung 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, gibt sie die Sammlung an, 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, 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 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 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 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 in erster Linie 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 Auflistungsbefehl verwenden zu können, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren sowie der lokalen Administratorgruppe 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.

Das folgende Beispiel zeigt, 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, der die Datenbank hostet, für die der Spaltenspeicherindex aktiviert oder deaktiviert wird, und den Namen des instance, wenn ein anderer instance als der Standard verwendet wird. Wenn Sie einen 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 den angegebenen SQL Server instance sein.

Hinweise

In der Regel verwenden Sie den Befehl columnStoreIndex, 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 in eine SQL-instance die den Spaltenspeicherindex unterstützt, 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 mit dem Namen TFS_DefaultCollection einer SQL-instance aktivieren, die auf einem Server mit dem Namen ContosoMain 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 aus 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 Mailserver 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 die von E-Mail-Adresse zu TFS@contoso.com und den SMTP-Mailserver als ContosoMailServerzu konfigurieren:

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

DBCompression

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

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, der die Datenbank hostet, für die die Seitenkomprimierung aktiviert oder deaktiviert wird, und den Namen des instance, wenn ein anderer instance als der Standard 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 nicht verwendet, 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 Onlineindexneuerstellung.

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

Sie würden in der Regel den Befehl dbCompression verwenden, wenn Sie eine Datenbank von einer SQL-instance die Komprimierung unterstützte, in eine datenbank verschieben, die dies nicht getan hat. 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 Komprimierung unterstützt, sollten Sie die Komprimierung möglicherweise erneut aktivieren, um Speicherplatz zu sparen.

Mit diesem Befehl wird nur geändert, ob Azure DevOps Server lieber die Datenbankseitenkomprimierung verwenden möchte oder nicht . Ihre Datenbanken müssen weiterhin in einer SQL-instance gehostet werden, deren Edition die Komprimierung unterstützt. Weitere Informationen finden Sie unter Von den Editionen von SQL Server unterstützte Features.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie die Seitenkomprimierung sofort aktivieren, wobei Indizes online neu erstellt werden, 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 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 geschieht in der Regel, um die Größe des Speichers zu reduzieren oder die Zeit beim Migrieren von Testergebnissen zu einem neuen Schema zu reduzieren.

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 testergebnisse gelöscht oder in der Vorschau angezeigt werden, und der Name des instance, wenn ein anderer instance als der Standard verwendet wird. Wenn Sie einen 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

Im folgenden Beispiel wird gezeigt, 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 ist für die Migration aller Bereitstellungsgruppen von einem Bereitstellungspool in einen anderen konzipiert.

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 oder ändert den Sicherheitsbezeichner (SID) von Benutzern und Gruppen in Ihrer Bereitstellung von Azure DevOps Server. 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 in eine Domäne oder von einer Domäne zu einer Arbeitsgruppe

  • Domänenübergreifendes Migrieren von Konten 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 behandelt 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.
zuaccountn 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 des 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 Befehl identitäten 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 anzeigen, ob die SID für jeden Benutzer oder jede Gruppe mit der SID in Windows übereinstimmt. Die Contoso1-Domänenadministratoren 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 nicht für Contoso1\hholtaktualisiert.

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 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 in Contoso1ContosoPrimegeändert wird. Um ein Systemkonto, beispielsweise Netzwerkdienst, zu ändern, müssen Sie einem zweistufigen Prozess folgen. Sie ändern zuerst das Dienstkonto von NT AUTHORITY\NETWORK SERVICE in ein Domänenkonto in der neuen Domäne TempSVC, und dann ändern Sie das Konto wieder in NETWORK SERVICE auf dem Server in der neuen Domäne. Die Konfigurationsdatenbank wird auf dem Server gehostet, der auf dem 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 auszuführen.

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]
Option BESCHREIBUNG
retry Erforderlich, wenn /dumplog nicht verwendet wird. Gibt an, dass der neueste Auftrag für die angegebene Projektauflistung erneut ausgeführt wird. Wenn Sie diese Option verwenden, müssen Sie auch entweder die Option /CollectionName oder /CollectionID verwenden.
Dumplog Erforderlich, wenn /retry nicht verwendet wird. Gibt an, dass die neueste 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 (/dumplog) wird. 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 (/dumplog) wird.

Voraussetzungen

Um den Befehl aufträge 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

Um einen Auftrag interaktiv zu wiederholen, 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"

OfflineDetach

Mit dem Befehl offlineDetach können Sie eine Offlinesammlungsdatenbank zu einer getrennten Offlinesammlungsdatenbank machen.

TfsConfig offlineDetach /configurationDB:<databaseName>
    /collectionDB:<databaseName>
Option BESCHREIBUNG
configurationDB Gibt den Namen der zu verwendenden Konfigurationsdatenbank an.
collectionDB Gibt den Namen der sammlungsdatenbank an, die getrennt werden soll.

Voraussetzungen

Um den offlineDetach-Befehl 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. Zuvor musste hierfür ein vollständiger und konsistenter Satz von Datenbanken (Konfiguration und alle Sammlungen) in einer Stagingumgebung wiederhergestellt werden, eine Azure DevOps Server Bereitstellung mithilfe dieser Datenbanken konfiguriert und die eine sammlung von Interesse getrennt werden.

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

Beispiel

Das folgende Beispiel veranschaulicht das Trennen einer Auflistungsdatenbank namens mithilfe TFS_PrimaryCollectioneiner Konfigurationsdatenbank mit dem Namen TFS_Configuration, wobei beide auf einer SQL-instance auf einem Server mit dem Namen ContosoTemp 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 vom Azure DevOps-Proxyserver verwendeten Einstellungen zu aktualisieren oder zu ändern. Azure DevOps Proxy Server 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 des Azure DevOps-Proxyservers können Sie die erforderliche Bandbreite für Wide Area-Verbindungen 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 einige der von diesem Dienst verwendeten Einstellungen zu verwalten.

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 unter Azure DevOps-Versionssteuerungsbefehlsreferenz.

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 zur Eingabe Ihrer Anmeldeinformationen auf Azure DevOps Services aufgefordert.
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 gehostet wird, im AccountName.DomainName/CollectionName Format.
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. (Hinzugefügt in TFS 2018 Update 1)
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 (hinzugefügt in TFS 2018 Update 1)

Voraussetzungen

Um den Proxybefehl verwenden zu können, 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.

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

Das folgende Beispiel zeigt, 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 das Registrieren 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.The following example shows how to change the service account used by the proxy for the project collection hosted on Azure DevOps Services. Die Auflistung heißt PhoneSaver, der für Azure DevOps Services verwendete Kontoname lautet HelenaPetersen.fabrikam.com, und das 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 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]
Option BESCHREIBUNG
Microsoft.analysisservices Erforderlich, wenn /all nicht verwendet wird. Gibt an, dass nur die Datenbank für Analysis Services neu erstellt wird. Wenn für Analysis Services keine Datenbank 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 den Servern, auf denen die Verwaltungskonsole für Azure DevOps ausgeführt wird

  • Die Sysadmin-Gruppe auf dem Server, auf dem bzw. auf denen die instance 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 auf andere Weise ändern.

Zum interaktiven Starten der Neuerstellung dieser Datenbanken 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 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 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. Sie müssen z. B. Azure DevOps Server für Projektsammlungen an datenbanken umleiten, wenn sie von der Konfigurationsdatenbank auf einem oder anderen Server gehostet werden. Sie müssen auch Azure DevOps Server an den Server umleiten, auf dem bzw. auf denen SQL Server Analysis Services ausgeführt wird, oder SQL Server Reporting Services, 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 Serverpaare und instance Namen 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 ausführen müssen, um die Konfiguration zu aktualisieren.
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 Installationsprozesses 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. Mit dieser Option müssen Sie /type oder /unattendfile 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 Geheimwerte 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. Dies umfasst 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 auf die aktuelle Version einer unterstützten vorherigen Version.
PreProductionUpgrade Testen Sie das Upgrade für eine vorhandene Azure DevOps Server Bereitstellung in einer Präproduktionsumgebung. Dies geschieht in der Regel mithilfe von Datenbanken, die aus Produktionssicherungen wiederhergestellt wurden. 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 angegebenen 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 Advanced ApplicationTierOnlyAdvanced-Typ.
ApplicationTierOnlyAdvanced Konfigurieren Sie eine neue Anwendungsebene mit vollständiger Kontrolle über alle Einstellungen. Die 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.
Klon Konfigurieren Sie eine neue Azure DevOps Server Bereitstellung, bei der es sich um einen Klon einer vorhandenen Bereitstellung handelt. Dies geschieht 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 Versionssteuerungsproxydienst.

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. Dies schließt Azure DevOps Server selbst ein. Sie müssen Azure DevOps Server installieren, müssen sie jedoch nicht konfigurieren, da dies mit dem Befehl unattend für Sie ausgeführt wird.

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 Datei für die unbeaufsichtigte Installation für eine grundlegende 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 ein Git-Repository für die Verwendung mit GVFS während der Konfiguration 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 Datei für die unbeaufsichtigte 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 erreicht werden, indem sie eine Zeile für das persönliche Zugriffstoken in der erstellten Datei ohne Aktualisierung wie folgt hinzufügen: PersonalAccessToken=PersonalAccessTokenValue.

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

Im folgenden Beispiel wird gezeigt, wie Sie eine Datei für die unbeaufsichtigte Überwachung für die Konfiguration von Azure DevOps Server Build auf einem Server erstellen, indem FabrikamFiber\BuildSVC Sie als Builddienstkonto verwenden, und anschließend Azure DevOps Server Build mithilfe dieser Datei für die unbeaufsichtigte Registrierung 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 mit hinzufügen ServiceAccountPassword=Password; , 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 dem Controller DefaultCollectionzugeordneten 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 Ziplogs-Befehl ist zum Sammeln von Protokollen konzipiert und löscht eine ZIP-Datei bei ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs