Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 Projects
benennen 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.txt
gespeichert.
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 TeamDatabases
befindet.
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_Configuration
umleiten.
Diese Datenbank wird in ContosoMain
der benannten Instanz TeamDatabases
gehostet.
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 DefaultCollection
zugeordnete 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