Zarządzanie lokalną usługą Azure DevOps przy użyciu narzędzia TFSConfig

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

Za pomocą narzędzia wiersza polecenia TFSConfig można wykonywać różne akcje administracyjne dla lokalnego wdrożenia usługi Azure DevOps.

TFSConfig można uruchomić z dowolnego komputera, na którym zainstalowano usługę Azure DevOps Server.

Lokalizacja narzędzia wiersza polecenia

Narzędzia wiersza polecenia usługi Azure DevOps są instalowane w katalogu /Tools serwera warstwy aplikacji usługi Azure DevOps.

• 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

Wymagania wstępne

Aby wiele poleceń działało poprawnie, tfSConfig musi mieć możliwość nawiązania połączenia z różnymi serwerami i usługami, które są częścią wdrożenia serwera TFS, a użytkownik z systemem TFSConfig będzie musiał mieć uprawnienia administracyjne dla tych samych serwerów i usług. Wymagania dotyczące określonych poleceń zostaną podane poniżej.

Wiele poleceń TFSConfig musi być uruchamianych z wiersza polecenia z podwyższonym poziomem uprawnień, nawet jeśli użytkownik ma poświadczenia administracyjne. Aby otworzyć wiersz polecenia z podwyższonym poziomem uprawnień, kliknij przycisk Start, kliknij prawym przyciskiem myszy wiersz polecenia, a następnie kliknij polecenie Uruchom jako administrator. Aby uzyskać więcej informacji, zobacz: Kontrola konta użytkownika.

Możesz również interaktywnie wykonywać akcje administracyjne przy użyciu konsoli administracyjnej dla usługi Azure DevOps Server. Zobacz Szybkie informacje o zadaniach administracyjnych.

Wyświetlanie listy poleceń i uzyskiwanie pomocy

Aby wyświetlić pełną listę poleceń TFSConfig, użyj polecenia help:

TFSConfig help

Aby uzyskać pomoc dotyczącą poszczególnych poleceń, użyj polecenia pomocy i określ nazwę polecenia, za pomocą którego chcesz uzyskać pomoc. Aby na przykład uzyskać pomoc dotyczącą polecenia kont :

TFSConfig help accounts

Konta

Aby zarządzać tymi kontami usługi Azure DevOps Server, użyj polecenia .

• konto usługi Azure DevOps Server
• konto źródeł danych dla usług SQL Server Reporting Services
• konto usługi Azure DevOps Proxy Server

Możesz również użyć tego polecenia, aby zmienić własność baz danych usługi Azure DevOps Server.

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

Operacja	Opis
AktualizujHasło	Zmienia hasło konta, które jest używane jako konto usługi. Zmienia istniejące konto i wszystkie typy kont działające jako podane konto.
Zmiana	Zmienia konto używane jako konto usługi. Dodaje nowe konto do niezbędnych zasobów i grup, przyznaje wymagane uprawnienia, a następnie ustawia usługę do jej użycia. Nie powoduje to usunięcia starego konta z zasobów. Jeśli nie używasz opcji accountType, konto usługi dla warstwy aplikacji zostanie zmienione.
Dodaj	Dodaje tylko nowe konto do niezbędnych zasobów. Przydatne w scenariuszach równoważenia obciążenia sieciowego. Użyj flagi 'kontynuuj', jeśli niektóre kolekcje są niedostępne. Proces dodawania można uruchomić ponownie później, aby zaktualizować wszelkie pominięte kolekcje. Dodaje konto do grup wymaganych do korzystania z konta jako konta usługi.
Ustawienie	Ustawia tylko usługę, aby korzystała z konta już dodanego do zasobów. Przydatne w scenariuszach równoważenia obciążenia sieciowego.
Usuń	Usuwa konto ze wszystkich zasobów. Należy zachować ostrożność podczas usuwania konta, ponieważ może to spowodować odmowę usługi innym serwerom.
ResetOwner	Jeśli bazy danych zostaną przywrócone w ramach przenoszenia, klonowania lub odzyskiwania po awarii, właściciel bazy danych może przełączyć się do administratora przywracającego serwer. Ta opcja iteruje wszystkie bazy danych i ustawia identyfikator logowania dbo do bieżącego właściciela.

Typ konta	Opis
AdminConsole	Użytkownicy konsoli administracyjnej to użytkownicy, którym przyznano minimalne uprawnienia w różnych zasobach systemowych do korzystania z konsoli.
ApplicationTier	Zmienia konto usługi w appPool dla podstawowych usług internetowych. (TFSService)
Proxy	Zmienia konto usługi w puli aplikacyjnej dla usług proxy w sieci Web. (TFSProxy)
ŹródłoDanychRaportowania	Zmienia konto używane przez raporty w celu uzyskania dostępu do danych raportowania. (TFSReports)

Wartość domyślna to ApplicationTier.

Klasa sqlInstance i databaseName są odpowiednie tylko do użycia podczas dodawania konta do baz danych przed skonfigurowaniem warstwy aplikacji. Jest to szczególnie przydatne w scenariuszach odzyskiwania po awarii, w których konieczne jest posiadanie innego konta przed uruchomieniem kreatora konfiguracji AT Only.

Opcja kontynuuj jest używana podczas dodawania lub zmieniania konta. W przypadku tych operacji konto jest zmieniane w każdej bazie danych kolekcji. Jeśli zostanie podana komenda "kontynuuj", system będzie działać dalej, jeśli nie można uzyskać dostępu do kolekcji. Można go uruchomić ponownie, gdy są one osiągalne.

Uwaga

Konta muszą mieć format domainName\userName. W przypadku kont systemowych należy użyć cudzysłowów wokół pełnej nazwy konta (na przykład "NT Authority\Network Service"). Konta systemowe nie wymagają hasła.

Parametr	Opis
Konto	Określa nazwę konta, które chcesz dodać, zmienić lub usunąć z przywoływałego typu konta, na przykład /AccountType:ApplicationTier.
Hasło	Określa hasło konta usługi. Ten parametr jest opcjonalny, jeśli używasz konta systemowego lub konta, które nie ma hasła, takiego jak usługa sieciowa.
sqlInstance	Używane tylko z /ResetOwner. Określa nazwę serwera z uruchomionym programem SQL Server i nazwę wystąpienia, jeśli chcesz użyć wystąpienia innego niż wystąpienie domyślne. Należy określić nazwę i wystąpienie w następującym formacie: ServerName\InstanceName.
nazwaBazyDanych	Używane tylko z /ResetOwner. Określa nazwę bazy danych, której własność ma zostać zmieniona. Za pomocą tego polecenia zresetujesz własność bazy danych określonej dla konta, w ramach którego uruchamiasz polecenie.
kontynuować	Aktualizuje wszystkie grupy, które nie są dostępne podczas uruchamiania polecenia. Ta opcja jest zwykle używana w scenariuszach równoważenia obciążenia sieciowego.

Wymagania wstępne

Aby użyć polecenia konta , musisz być członkiem:

• grupa zabezpieczeń Administratorzy usługi Azure DevOps
• rola administratora systemu dla wszystkich wystąpień programu SQL Server używanych przez wystąpienie usługi Azure DevOps Server.

Jeśli używasz opcji /proxy, musisz być administratorem na serwerze proxy.

Aby uzyskać więcej informacji, zobacz Dokumentacja uprawnień dla usługi Azure DevOps Server.

Uwagi

Użyj polecenia konta, aby zautomatyzować zmiany kont usługi, baz danych i grup kont usługi w serwerze Azure DevOps Server. Możesz skonfigurować konta, które zostały już utworzone, ale nie można tworzyć kont.

Przed zmianą domeny lub grupy roboczej konta, konto musi mieć uprawnienie "Konto jest poufne i nie można go delegować" na serwerze warstwy aplikacji. Aby uzyskać więcej informacji, zobacz tę stronę w witrynie firmy Microsoft: Włączanie Uwierzytelniania Delegowanego.

Polecenie accounts obsługuje lokalne wdrożenia usługi Azure DevOps Server. Aby zmienić właściciela konta usługi Azure DevOps Services, zobacz Zmienianie własności konta.

Przykłady

Zmień konto usługi źródeł danych dla usług Reporting Services na nowe konto w domenie Contoso, Contoso\NewAccounti hasło na Password.

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

Dodaj konto systemu usługi sieciowej do grup kont usług dla usługi Azure DevOps Server (konta systemowe nie mają haseł).

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

Zmień własność bazy danych TFS_Warehouse na SQL Serverze ContosoMain w nazwanej instancji TeamDatabases na konto użytkownika, pod którym uruchamiasz polecenie.

Uwaga

Nie można określić, jakie konto ma być ustawione jako właściciel baz danych podczas korzystania z tego polecenia. Właściciel zostanie ustawiony na konto, z którego uruchamiasz polecenie.

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

---

DodajRaportyProjektu

Uwaga

Polecenie addProjectReports jest dostępne w programie TFS 2017.1 i nowszych wersjach.

Aby dodać lub zastąpić raporty dla istniejącego projektu zespołowego, należy użyć polecenia addProjectReports.

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

Opcja	Opis
kolekcja	To jest wymagane. Adres URL kolekcji projektów zespołowych.
projekt zespołowy	To jest wymagane. Określa nazwę projektu zespołowego.
szablon	To jest wymagane. Określa nazwę szablonu procesu. Dostępne opcje to Agile, CMMI i Scrum.
siła	Opcjonalny. Określa, że raporty powinny zostać zastąpione, jeśli już istnieją.

Wymagania wstępne

Aby użyć polecenia addProjectReports, musisz mieć uprawnienia do uruchamiania TFSConfig i przekazywania raportów do usługi Reporting Service.

Uwagi

Użyj polecenia addProjectReports, gdy projekt nie ma raportów lub chcesz zaktualizować raporty zdefiniowane dla procesu.

Może być konieczne użycie tego polecenia w następujących przypadkach:

• Projekt został utworzony w portalu usługi Azure DevOps, a nie w programie Visual Studio
• Projekt został utworzony na podstawie programu Visual Studio, jednak raportowanie nie zostało skonfigurowane w usłudze Azure DevOps Server.

Jeśli chcesz zastąpić raporty w projekcie domyślnymi raportami, ponieważ uaktualniono serwer Usługi Azure DevOps Server i stare raporty w projekcie nie są już zgodne, użyj opcji /force. Jeśli masz dostosowane raporty, przed wykonaniem tej czynności utwórz kopię zapasową.

Aby dowiedzieć się więcej na temat dodawania raportów do lokalnego serwera Azure DevOps Server, zobacz Dodawanie raportów do projektu.

Przykład

W poniższym przykładzie pokazano, jak dodać raporty Agile do projektu MyProject w kolekcji projektów http://myTfsServer:8080/tfs/DefaultCollection.

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

---

Uwierzytelnianie

Polecenie Authentication zmienia protokół uwierzytelniania sieciowego, który jest używany przez warstwę aplikacji lub witrynę proxy serwera Azure DevOps Server.

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

Opcja

Opis

/viewAll

Wyświetla bieżące ustawienia uwierzytelniania dla usługi Azure DevOps Server.

/provider: { NTLM | Negocjuj }

Określa dostawcę uwierzytelniania, który chcesz skonfigurować dla witryny internetowej.

• NTLM: użyj protokołu uwierzytelniania NTML
• Negotiate: użyj protokołu uwierzytelniania Negotiate (Kerberos)

/siteType

Określa witrynę internetową (warstwę aplikacji lub serwer proxy), której protokół uwierzytelniania sieciowego chcesz zmienić. Warstwa aplikacji jest domyślna.

Wymagania wstępne

Aby użyć polecenia Authentication, musisz być członkiem grupy zabezpieczeń Administratorzy usługi Azure DevOps i administratorem lokalnym na serwerze warstwy aplikacji lub serwerze proxy, w zależności od wartości opcji siteType.

Uwagi

Polecenie Authentication jest używane przez administratora, który chce zmienić protokół uwierzytelniania sieciowego dla co najmniej jednej witryny internetowej, na której opiera się usługa Azure DevOps Server. Administrator uruchamia to polecenie z warstwy aplikacji, aby zaktualizować te witryny internetowe, które wymagają zmiany w protokole uwierzytelniania sieciowego. Polecenie zmienia właściwość NTAuthenticationProviders w metabazie usług IIS.

Przed użyciem polecenia Authentication w celu zmiany protokołu uwierzytelniania można uruchomić polecenie za pomocą opcji /viewAll, aby zobaczyć, jakie są istniejące ustawienia.

Przykład

Poniższy przykład przedstawia bieżącą wartość przypisaną dla protokołu uwierzytelniania sieciowego.

TFSConfig Authentication /viewAll

---

Certyfikaty

Użyj polecenia certyfikatów, aby zmienić sposób konfigurowania certyfikatów na potrzeby uwierzytelniania klienta we wdrożeniu Azure DevOps Server, który korzysta z HTTPS/SSL i certyfikatów.

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

Opcja	Opis
maszyna	Określa, że lista certyfikatów będzie pochodzić z kontekstu komputera lokalnego zamiast bieżącego kontekstu użytkownika.
dezaktywować	Określa, że ustawienie certyfikatu uwierzytelniania klienta zostanie wyłączone.
automatyczny wybór	Określa, że certyfikat zostanie automatycznie wybrany z listy certyfikatów. Okno Zarządzanie certyfikatami klienta nie zostanie otwarte.
noprompt	Określa, że okno Zarządzanie certyfikatami klienta nie zostanie otwarte po uruchomieniu polecenia Certyfikaty.
odciski palca	Określa, że będzie używany certyfikat zgodny z określonym odciskiem palca. Można określić więcej niż jeden certyfikat, oddzielając poszczególne odciski palca przecinkami.

Wymagania wstępne

Aby użyć polecenia certyfikatów , musisz być członkiem grupy zabezpieczeń Administratorzy usługi Azure DevOps i lokalnej grupy Administratorzy na komputerze, z którego wykonujesz polecenie. Aby uzyskać więcej informacji, zobacz Dokumentacja uprawnień dla usługi Azure DevOps Server.

Uwagi

Domyślnie polecenie certyfikaty automatycznie wybierze certyfikat klienta z listy certyfikatów dla bieżącego użytkownika. Można jednak użyć opcji dla polecenia, aby określić określony certyfikat lub certyfikaty z bieżącego kontekstu użytkownika lub z kontekstu komputera lokalnego.

Przed użyciem polecenia certyfikatów należy najpierw skonfigurować serwery we wdrożeniu serwera Azure DevOps Server w celu korzystania z certyfikatów. Aby uzyskać więcej informacji, zobacz Konfigurowanie protokołu HTTPS przy użyciu protokołu Secure Sockets Layer (SSL) dla usługi Azure DevOps Server.

Polecenie certificates służy do konfigurowania certyfikatów klienta używanych przez wdrożenie Azure DevOps Server, które zostało skonfigurowane do używania protokołu HTTPS/SSL i certyfikatów. Jeśli używasz polecenia Certyfikaty bez opcji, certyfikat klienta zostanie automatycznie wybrany z bieżącego kontekstu użytkownika, z którego uruchamiasz polecenie.

Przykłady

W poniższym przykładzie pokazano, jak określić certyfikat komputera lokalnego, który ma odcisk palca aa bb cc dd ee bez monitowania.

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

Poniższy przykład pokazuje, jak określić przy użyciu automatycznego wyboru certyfikatu klienta z bieżącego magazynu użytkownika.

TfsConfig certificates /autoselect

---

ZmieńIDSerwera

Polecenie changeServerID zmienia identyfikatory GUID skojarzone z bazami danych dla usługi Azure DevOps Server. Identyfikatory GUID muszą być unikatowe we wdrożeniu usługi Azure DevOps Server. Jeśli więcej niż jedna baza danych ma ten sam identyfikator GUID, wdrożenie może stać się niestabilne lub bezużyteczne. Można zmienić identyfikator GUID bazy danych konfiguracji oraz identyfikatory GUID wszystkich baz danych kolekcji projektów znajdujących się we wdrożeniu, lub oba te identyfikatory.

Chociaż zwykle nie używa się tego polecenia w codziennych operacjach, można użyć tego polecenia w następujących okolicznościach:

• Przywrócono wdrożenie na nowym sprzęcie, stare wdrożenie jest nadal operacyjne i chcesz korzystać z obu wdrożeń. Ten scenariusz jest czasami określany jako klonowanie serwera.

• Chcesz przetestować aktualizację oprogramowania lub konfigurację sprzętu w ramach zduplikowanego wdrożenia, aby nie ryzykować zakłócania środowiska produkcyjnego.

• Chcesz w pełni przetestować przywracanie baz danych do nowego sprzętu w laboratorium testowym lub oddzielnym środowisku, aby upewnić się, że wdrożenie można przywrócić.

• Identyfikator GUID dla bazy danych kolekcji należy zresetować po przeniesieniu go do innego wdrożenia, dla którego ten identyfikator GUID jest już zarezerwowany.

Uwaga

Polecenie changeServerID nie jest odwracalne. Po zmianie identyfikatora GUID nie można cofnąć tej zmiany, z wyjątkiem przywracania poprzedniej wersji tej bazy danych.

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

Opcja	Opis
sqlInstance	To jest wymagane. Określa nazwę serwera z uruchomionym programem SQL Server i nazwę wystąpienia, jeśli chcesz użyć wystąpienia innego niż wystąpienie domyślne. Jeśli określisz wystąpienie, musisz użyć formatu: ServerName\InstanceName.
nazwaBazyDanych	To jest wymagane. Określa nazwę bazy danych konfiguracji dla usługi Azure DevOps Server. Domyślnie nazwa tej bazy danych jest TFS_ConfigurationDB.
projectCollectionsOnly	Określa, że zostaną zmienione tylko identyfikatory GUID dla kolekcji.
configDBOnly	Określa, że zostanie zmieniony tylko identyfikator GUID bazy danych konfiguracji.
nazwaKolekcji	Określa utworzenie nowego identyfikatora wystąpienia dla konkretnej kolekcji, ale nie dla wystąpienia Azure DevOps ani innych kolekcji.

Wymagania wstępne

Aby użyć polecenia changeServerID, musisz być członkiem grupy zabezpieczeń Administratorzy Azure DevOps oraz członkiem roli zabezpieczeń administratora systemu dla wszystkich wystąpień programu SQL Server używanych przez usługę Azure DevOps Server. Aby uzyskać więcej informacji, zobacz Dokumentacja uprawnień dla usługi Azure DevOps.

Uwagi

Użyj polecenia changeServerID, aby utworzyć dyskretny duplikat wdrożenia usługi Azure DevOps Server na potrzeby testowania lub klonowania. Po użyciu changeServerID polecenia, należy skierować klientów, aby utworzyć połączenie ze zmienionym serwerem, zanim będzie można go użyć.

Przykład

W poniższym przykładzie pokazano, jak zmienić GUID-y wszystkich baz danych w wdrożeniu Azure DevOps Server, gdzie baza danych konfiguracji jest hostowana na serwerze o nazwie ContosoMain na nazwanym wystąpieniu TeamDatabases w SQL Server.

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

---

Indeks Kodów

Użyj polecenia codeIndex, aby zarządzać indeksowaniem kodu na serwerze Azure DevOps Server. Na przykład możesz zresetować indeks, aby naprawić informacje CodeLens lub wyłączyć indeksowanie w celu zbadania problemów z wydajnością serwera.

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

Opcja	Opis
status indeksowania	Pokaż stan i konfigurację usługi indeksowania kodu.
setIndexing	w: rozpocznij indeksowanie wszystkich zestawów zmian. wyłączyć: zatrzymaj indeksowanie wszystkich zestawów zmian. keepupOnly: zatrzymaj indeksowanie wcześniej utworzonych zestawów zmian i rozpocznij indeksować tylko nowe zestawy zmian.
ignoreList	Określa listę plików kodu i ich ścieżki, których nie chcesz indeksować. dodaj: dodaj plik, którego nie chcesz indeksować na liście ignorowanych plików. usunąć: usuń plik, który chcesz zaindeksować z listy ignorowanych plików. removeAll: Wyczyść zignorowaną listę plików i rozpocznij indeksowanie wszystkich plików. widok: Zobacz wszystkie pliki, które nie są indeksowane. ServerPath: określa ścieżkę do pliku kodu. Symbol wieloznaczny (*) można użyć na początku, na końcu lub na obu końcach ścieżki serwera.
listaDużychPlików	Pokazuje określoną liczbę plików, które przekraczają określony rozmiar w KB. Następnie możesz użyć opcji /ignoreList, aby wykluczyć te pliki z indeksowania. W tym celu musisz Team Foundation Server 2013 z aktualizacją 3.
ponowne indeksowanie wszystkich	Wyczyść wcześniej indeksowane dane i ponownie uruchom indeksowanie.
zniszczIndeksKodu	Usuń indeks kodu i usuń wszystkie indeksowane dane. Nie wymaga potwierdzenia, jeśli używasz opcji /noPrompt.
tymczasowyLimitRozmiaruDanych	Kontrolowanie ilości danych tymczasowych tworzonych przez funkcję CodeLens podczas przetwarzania zestawów zmian. Domyślny limit to 6 GB (2 GB w aktualizacji Update 5). widok: Pokaż bieżący limit rozmiaru. SizeInGBs: zmień limit rozmiaru. wyłącz: usuń limit rozmiaru. Ten limit jest sprawdzany, zanim funkcja CodeLens przetworzy nowy zestaw zmian. Jeśli dane tymczasowe przekraczają ten limit, funkcja CodeLens wstrzyma przetwarzanie przeszłych zmian, a nie nowych. Funkcja CodeLens ponownie uruchomi przetwarzanie, gdy dane zostaną wyczyszczone i ich ilość spadnie poniżej tego limitu. Oczyszczanie jest uruchamiane automatycznie raz dziennie. Oznacza to, że dane tymczasowe mogą przekroczyć ten limit, dopóki czyszczenie nie zostanie uruchomione. W tym celu będziesz potrzebować programu Team Foundation Server 2013 z aktualizacją Update 4.
okres historii indeksu	Określ, jak długo indeksować historię zmian. Wpływa to na ilość historii wyświetlanej przez CodeLens. Domyślny limit to 12 miesięcy. Oznacza to, że funkcja CodeLens pokazuje historię zmian tylko z ostatnich 12 miesięcy. widok: Wyświetl bieżącą liczbę miesięcy. całość: utwórz indeks dla całej historii zmian. NumberOfMonths: zmień liczbę miesięcy używanych do indeksowania historii zmian. W tym celu będziesz potrzebować programu Team Foundation Server 2013 z aktualizacją Update 4.
nazwaKolekcji	Określa nazwę kolekcji projektu, na której ma zostać uruchomione polecenie CodeIndex. Wymagane, jeśli nie używasz /CollectionId.
identyfikatorKolekcji	Określa numer identyfikacyjny kolekcji projektu, na której ma zostać uruchomione polecenie CodeIndex. Wymagane, jeśli nie używasz /CollectionName

Wymagania wstępne

Aby użyć polecenia codeIndex, musisz być członkiem grupy zabezpieczeń Administratorów Azure DevOps. Zobacz Dokumentacja uprawnień dla usługi Azure DevOps Server.

Przykłady

Aby wyświetlić stan i konfigurację indeksowania kodu:

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

Aby rozpocząć indeksowanie wszystkich zestawów zmian:

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

Aby zatrzymać indeksowanie wcześniej utworzonych zestawów zmian i zacząć indeksować tylko nowe zestawy zmian:

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

Aby znaleźć maksymalnie 50 plików, które są większe niż 10 KB:

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

Aby wykluczyć określony plik z indeksowania i dodać go do listy ignorowanych plików:

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

Aby wyświetlić wszystkie pliki, które nie są indeksowane:

TfsConfig codeIndex /ignoreList:view

Aby wyczyścić wcześniej indeksowane dane i ponownie uruchomić indeksowanie:

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

Aby zapisać całą historię zestawu zmian:

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

Aby usunąć limit rozmiaru danych tymczasowych CodeLens i kontynuować indeksowanie niezależnie od tymczasowego rozmiaru danych:

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

Aby usunąć indeks kodu z potwierdzeniem:

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

---

Kolekcja

Za pomocą polecenia collection można dołączać, odłączać lub usuwać kolekcję projektów z wdrożenia usługi Azure DevOps Server. Możesz również użyć polecenia kolekcji , aby zduplikować bazę danych istniejącej kolekcji, zmienić jej nazwę i dołączyć ją do wdrożenia. Ten proces jest czasami nazywany klonowaniem kolekcji.

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

Opcja	Opis
przymocować	Wymagane, jeśli nie są używane /detach ani /delete. Jeśli określisz tę opcję, musisz również użyć opcji /collectionDB. Jako opcję możesz również użyć /collectionName i /clone z tą opcją. Jeśli używasz opcji /attach, określona baza danych kolekcji zostanie dodana do wdrożenia usługi Azure DevOps Server.
utwórz	Tworzy kolekcję.
odłączyć	Wymagane, jeśli nie są używane /attach ani /delete. Jeśli określisz tę opcję, musisz również użyć opcji /collectionName. Jeśli używasz opcji /detach, baza danych dla określonej kolekcji zostanie zatrzymana, a kolekcja zostanie odłączona od wdrożenia usługi Azure DevOps Server.
usuń	Wymagane, jeśli nie są używane /detach ani /attach. Jeśli określisz tę opcję, musisz również użyć opcji /collectionName. Jeśli używasz opcji /delete, baza danych dla określonej kolekcji zostanie zatrzymana, a kolekcja zostanie trwale odłączona od usługi Azure DevOps Server. Nie będzie można ponownie dołączyć bazy danych kolekcji do tego lub innego wdrożenia.
Nazwa Kolekcji	Określa nazwę kolekcji projektów. Jeśli nazwa kolekcji zawiera spacje, musisz ująć nazwę w cudzysłów (na przykład "Moja kolekcja"). Wymagane, jeśli jest używana /detach lub /delete. Jeśli używasz tej opcji z /detach lub /delete, określa kolekcję, która zostanie odłączona lub usunięta. Jeśli używasz tej opcji z /attach, to ustala nową nazwę dla kolekcji. Jeśli używasz tej opcji zarówno z /attach, jak i z /clone, określa to nazwę dla zduplikowanej kolekcji.
CollectionDB	Wymagane, jeśli /attach jest używane. Ta opcja określa nazwę serwera z uruchomionym programem SQL Server oraz nazwę bazy danych kolekcji hostowanej na tym serwerze.
NazwaSerwera	Określa nazwę serwera, który hostuje bazę danych konfiguracji dla usługi Azure DevOps Server, oraz nazwę wystąpienia, jeśli chcesz użyć wystąpienia innego niż wystąpienie domyślne. Jeśli określisz wystąpienie, musisz użyć formatu: ServerName\InstanceName.
Nazwa bazy danych	Określa nazwę bazy danych konfiguracji. Domyślnie nazwa tej bazy danych jest TFS_ConfigurationDB.
klon	Jeśli określisz tę opcję, oryginalna baza danych kolekcji zostanie dołączona jako klon w programie SQL Server, a ta baza danych zostanie dołączona do usługi Azure DevOps Server. Ta opcja jest używana głównie w ramach dzielenia kolekcji projektów.

Wskazówka

Opcja /delete nie spowoduje usunięcia bazy danych kolekcji z programu SQL Server. Po usunięciu bazy danych kolekcji z usługi Azure DevOps Server możesz usunąć bazę danych ręcznie z programu SQL Server.

Wymagania wstępne

Aby użyć polecenia kolekcji, musisz być członkiem grupy zabezpieczeń Administratorzy programu Team Foundation, a także lokalnej grupy Administratorzy na komputerze, na którym działa TfsConfig. Musisz również być członkiem roli zabezpieczeń sysadmin dla wszystkich instancji SQL Server używanych przez bazy danych usługi Azure DevOps Server. Jeśli wdrożenie jest zintegrowane z SharePoint i używasz opcji /delete, musisz również być członkiem grupy Administratorzy farmy SharePoint, z której usuwasz zbiór witryn.

Aby uzyskać więcej informacji, zobacz Dokumentacja uprawnień dla usługi Azure DevOps Server.

Uwagi

Aby interaktywnie zarządzać kolekcjami lub utworzyć kolekcję, możesz użyć węzła Kolekcje projektów w konsoli administracyjnej usługi Azure DevOps. Zobacz Zarządzanie kolekcjami projektów.

Przykłady

W poniższym przykładzie pokazano, jak trwale usunąć kolekcję projektów Contoso Summer Intern Projects z wdrożenia usługi Azure DevOps Server.

TfsConfig collection /delete /CollectionName:"Contoso Summer Intern Projects"

TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.
Deleting a project collection is an irreversible operation. A deleted collection cannot be reattached to the same or another Team Foundation Server. Are you sure you want to delete 'Contoso Summer Intern Projects'? (Yes/No)
Yes
Found Collection 'Contoso Summer Intern Projects' Deleting...
The delete of collection 'Contoso Summer Intern Projects' succeeded.

W poniższym przykładzie pokazano, jak zduplikować kolekcję projektów Contoso Summer Interns Projects, nadać jej nazwę Contoso Winter Interns Projectsi dołączyć zduplikowaną kolekcję do wdrożenia usługi Azure DevOps Server.

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

---

Indeks Magazynowania Kolumnowego

Uwaga

Dostępność poleceń: wymaga programu TFS 2015.2 i nowszych wersji.

Użyj polecenia columnStoreIndex, aby włączyć lub wyłączyć indeksy przechowywania kolumn dla baz danych używanych przy wdrożeniu serwera Azure DevOps.

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

Opcja	Opis
Włączone	Określa, czy włączasz lub wyłączasz indeks magazynujący kolumny dla odpowiedniego wystąpienia i bazy danych SQL.
sqlInstance	Określa nazwę serwera, który hostuje bazę danych, dla której indeks magazynu kolumn jest włączany lub wyłączany, oraz nazwę instancji, jeśli używana jest inna niż domyślna instancja. Jeśli określisz wystąpienie, musisz użyć formatu: ServerName\InstanceName.
nazwaBazyDanych	Określa nazwę bazy danych, dla której indeks kolumnowy jest włączany lub wyłączany.

Wymagania wstępne

Aby użyć polecenia columnStoreIndex, musisz należeć do roli sysadmin dla określonego wystąpienia programu SQL Server.

Uwagi

Zazwyczaj należy użyć polecenia indeks kolumnowy, jeśli przenosisz bazę danych z wystąpienia SQL, które obsługiwało indeks kolumnowy, do takiego, który go nie obsługuje. W takim przypadku należy wyłączyć wszystkie indeksy kolumnowe, aby móc pomyślnie przenieść bazy danych. Podobnie, jeśli przenosisz bazę danych z powrotem do wystąpienia SQL, które obsługuje indeks magazynu kolumn, możesz ponownie włączyć indeks magazynu kolumn, aby zaoszczędzić miejsce i uzyskać wydajność.

Przykład

W poniższym przykładzie pokazano, jak włączyć indeks magazynu kolumn dla bazy danych o nazwie TFS_DefaultCollection w wystąpieniu SQL uruchomionym na serwerze o nazwie ContosoMain w nazwanym wystąpieniu TeamDatabases.

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

---

Konfigurowanie poczty e-mail

Skonfiguruj serwer z uruchomionym serwerem Azure DevOps Server, aby używać istniejącego serwera SMTP na potrzeby alertów e-mail.

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

Opcja	Opis
FromEmailAddress	Określa adres, z którego mają być wysyłane powiadomienia e-mail z usługi Azure DevOps Server, takie jak powiadomienia o zaewidencjonowaniu, przypisaniu do Ciebie elementu roboczego lub inne powiadomienia. Ten adres jest również sprawdzany pod kątem ważności i w zależności od konfiguracji serwera może być konieczne reprezentowanie prawidłowego konta e-mail na serwerze poczty. Jeśli adres nie istnieje lub jest nieprawidłowy, zostanie użyty domyślny adres e-mail.
SmtpHost	Określa nazwę serwera, który hostuje serwer poczty.

Wymagania wstępne

Aby użyć configureMail polecenia, musisz być członkiem grupy zabezpieczeń Administratorzy programu Team Foundation na serwerze warstwy aplikacji usługi Azure DevOps. Aby uzyskać więcej informacji, zobacz Dokumentacja uprawnień dla usługi Azure DevOps Server

Uwagi

Można również użyć konsoli administracyjnej do skonfigurowania serwera Azure DevOps Server do korzystania z serwera SMTP.

Przykład

W poniższym przykładzie przedstawiono składnię używaną do konfigurowania adresu e-mail na TFS@contoso.com oraz serwera poczty SMTP na ContosoMailServer.

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

---

DbCompression

Użyj polecenia dbCompression, aby włączyć lub wyłączyć kompresję strony bazy danych dla baz danych używanych przez wdrożenie usługi Azure DevOps Server.

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

Opcja	Opis
pageCompression	Określa, czy włączasz lub wyłączasz kompresję strony dla danego wystąpienia i bazy danych SQL.
sqlInstance	Określa nazwę serwera, który hostuje bazę danych, dla której kompresja strony jest włączona lub wyłączona, oraz nazwę wystąpienia, jeśli jest używane wystąpienie inne niż domyślne. Jeśli określisz wystąpienie, musisz użyć formatu: ServerName\InstanceName
nazwaBazyDanych	Określa nazwę bazy danych, dla której kompresja strony jest włączona lub wyłączona.
OdbudujTeraz	Opcjonalny. Określa, czy indeksy bazy danych powinny zostać od razu skompilowane (i skompresowane lub dekompresowane w razie potrzeby). Jeśli nie jest używany, indeksy zostaną ponownie skompilowane przez zadanie w tle, które jest uruchamiane co tydzień.
niedostępny	Opcjonalny. Używane tylko w połączeniu z /rebuildNow. Jeśli nie określono /offline, indeksy zostaną ponownie skompilowane w trybie online. Jeśli określono /offline, indeksy zostaną ponownie skompilowane w trybie offline. Spowoduje to zablokowanie innych operacji, ale może być szybsze niż ponowne kompilowanie indeksu online.

Wymagania wstępne

Aby użyć polecenia dbCompression, musisz być członkiem roli administratora systemu dla określonego wystąpienia programu SQL Server.

Uwagi

Zazwyczaj używa się polecenia dbCompression, jeśli przenosisz bazę danych z wystąpienia SQL, które obsługiwało kompresję do tej, która nie była obsługiwana. W takim przypadku należy wyłączyć kompresję i dekompresować wszystkie indeksy przed pomyślnym przeniesieniem baz danych. Podobnie, jeśli przenosisz bazę danych z powrotem do wystąpienia SQL, które obsługuje kompresję, możesz ponownie włączyć kompresję w celu zaoszczędzenia miejsca.

To polecenie zmienia tylko to, czy usługa Azure DevOps Server woli korzystać z kompresji strony bazy danych, czy nie — bazy danych muszą być nadal hostowane w wystąpieniu SQL, którego wersja obsługuje kompresję. Aby uzyskać więcej informacji, zobacz Funkcje obsługiwane przez wersje programu SQL Server.

Przykład

W poniższym przykładzie pokazano, jak natychmiast włączyć kompresję strony z indeksami ponownie skompilowanymi w trybie online dla bazy danych o nazwie TFS_DefaultCollection w wystąpieniu SQL uruchomionym na serwerze o nazwie ContosoMain w nazwanym wystąpieniu TeamDatabases.

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

---

UsuńWynikiTestów

Używaj polecenia deleteTestResults, aby usunąć stare przechowywane wyniki testów z magazynu zbiorów. Zazwyczaj odbywa się to w celu zmniejszenia rozmiaru przechowywanych danych lub skrócenia czasu potrzebnego na migrację wyników testów do nowego schematu.

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

Opcja	Opis
wiekWDniach	Wyniki testów starsze niż określona liczba dni zostaną usunięte lub będą w wersji zapoznawczej.
sqlInstance	Nazwa serwera, który hostuje bazę danych, dla której wyniki testów są usuwane lub wyświetlane w wersji zapoznawczej, oraz nazwa wystąpienia, jeśli jest używane wystąpienie inne niż domyślne. Jeśli określisz wystąpienie, musisz użyć formatu: ServerName\InstanceName.
nazwaBazyDanych	Nazwa bazy danych, dla której wyniki testów są usuwane lub wyświetlane w wersji zapoznawczej.
typ	Opcjonalny. Typ wyników testu do usunięcia. Prawidłowe wartości to zautomatyzowane, ręcznei wszystkie.
podgląd	Opcjonalny. Wyświetl liczbę wyników testów, które zostaną usunięte w oparciu o wiek wyrażony w dniach, ale nie usuwaj tych wyników.

Wymagania wstępne

Aby użyć polecenia deleteTestResults, musisz być członkiem roli sysadmin dla określonego wystąpienia programu SQL Server.

Uwagi

Użyj parametru /preview, aby wyświetlić wyniki testów posortowane według nazwy projektu i roku bez usuwania tych wyników.

Przykład

W poniższym przykładzie pokazano, jak usunąć wyniki testów ręcznych starszych niż 60 dni dla bazy danych o nazwie TFS_DefaultCollection w wystąpieniu SQL uruchomionym na serwerze o nazwie ContosoMain w nazwanym wystąpieniu TeamDatabases.

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

---

Pula wdrożeniowa

Polecenie deploymentPool jest przeznaczone do migrowania wszystkich grup wdrożeń z jednej puli wdrożeń do innej.

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

Opcja	Opis
fromPool	Nazwa puli źródłowej.
toPool	Nazwa puli docelowej.

---

Tożsamości

Polecenie tożsamości wyświetla listę lub zmienia identyfikator zabezpieczeń (SID) użytkowników i grup we wdrożeniu Azure DevOps Server. Może być konieczne zmianę lub zaktualizowanie identyfikatora SID dla użytkowników i grup w jednym z następujących scenariuszy:

• Zmiana domeny wdrożenia

• Zmiana z grupy roboczej na domenę lub z domeny na grupę roboczą

• Migrowanie kont między domenami w usłudze Active Directory

Uwaga

Nie trzeba uruchamiać tego polecenia, jeśli zmieniasz domeny w tym samym lesie usługi Active Directory. Usługa Azure DevOps Server automatycznie będzie obsługiwać zmiany identyfikatora SID dla przemieszczeń w obrębie tego samego lasu.

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

Opcja	Opis
zmiana	Określa, że chcesz zmienić tożsamości zamiast ich wymieniania.
z domeny	Wymagane w przypadku używania /change. Określa oryginalną domenę tożsamości, które chcesz zmienić. Jeśli zmieniasz środowisko z grupy roboczej, określ nazwę komputera.
todomena	Wymagane przy użyciu /zmiana. Określa domenę, do której chcesz zmienić tożsamość. Jeśli przechodzisz na grupę roboczą, określ nazwę komputera.
konto	Określa nazwę konta, dla którego chcesz wymienić lub zmienić tożsamość.
do rozliczenia / na konto	Określa nazwę konta, do którego chcesz zmienić tożsamości.
SqlInstance	Określa nazwę serwera z uruchomionym programem SQL Server i nazwę wystąpienia, jeśli chcesz użyć wystąpienia innego niż wystąpienie domyślne. Jeśli określisz wystąpienie, musisz użyć następującego formatu: ServerName\InstanceName
Nazwa bazy danych	Określa nazwę bazy danych konfiguracji dla usługi Azure DevOps Server.

Wymagania wstępne

Aby użyć polecenia tożsamości , musisz być członkiem grupy zabezpieczeń Administratorzy programu Team Foundation i członkiem roli administratora systemu dla wszystkich wystąpień programu SQL Server używanych przez program Team Foundation Server. Aby uzyskać więcej informacji, zobacz Ustawianie uprawnień administratora dla usługi Azure DevOps Server.

Uwagi

Opcjonalnie możesz określić bazę danych, aby zmienić tożsamości przed skonfigurowaniem serwera warstwy aplikacji na potrzeby wdrożenia. Możesz na przykład określić bazę danych, aby zmienić konto usługi podczas klonowania wdrożenia serwera Azure DevOps Server.

W przypadku zmiany tożsamości konto docelowe lub konta muszą już istnieć w systemie Windows.

Przed zaktualizowaniem właściwości kont, które zmienisz za pomocą tego polecenia, musisz poczekać na następną synchronizację tożsamości z systemem Windows. To wymaganie obejmuje zmiany z grupy na użytkownika, z użytkownika na grupę i z konta domeny na konto lokalne.

Przykłady

W poniższym przykładzie pokazano, jak wyświetlić listę nazw wszystkich użytkowników i grup systemu Windows przechowywanych w usłudze Azure DevOps Server oraz wyświetlać, czy identyfikator SID dla każdego użytkownika lub grupy jest zgodny z identyfikatorem SID w systemie Windows. Administratorzy domeny Contoso1 utworzyli grupy domen, takie jak Contoso1\\Developers i Contoso1\\Testers, aby ułatwić zarządzanie uprawnieniami w usługach Azure DevOps Server, SQL Server Reporting Services i Produktach programu SharePoint.

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.

W poniższym przykładzie pokazano, jak zmienić identyfikatory SID dla wszystkich kont w usłudze Azure DevOps Server z domeny Contoso1 na identyfikatory SID dla kont, które mają pasujące nazwy w domenie ContosoPrime. Tylko nazwy kont, które są zgodne, będą miały zaktualizowane identyfikatory SID. Jeśli na przykład konto hholt istnieje jako Contoso1\hholt i ContosoPrime\hholt, identyfikator SID konta zostanie zmieniony na identyfikator SID dla ContosoPrime\hholt. Jeśli konto ContosoPrime\hholt nie istnieje, identyfikator SID nie zostanie zaktualizowany dla Contoso1\hholt.

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

W poniższym przykładzie pokazano, jak zmienić konto dla pojedynczego konta użytkownika, Contoso1\hholt, na konto innego konta użytkownika, ContosoPrime\jpeoples.

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

W poniższym przykładzie pokazano, jak zmienić identyfikator SID konta usługi NT AUTHORITY\NETWORK SERVICE używanego we wdrożeniu serwera Azure DevOps Server podczas zmiany domeny wdrożenia z Contoso1 na ContosoPrime. Aby zmienić konto systemowe, takie jak usługa sieciowa, należy wykonać proces dwuetapowy. Najpierw zmień konto usługi z NT AUTHORITY\NETWORK SERVICE na konto domeny w nowej domenie TempSVC, a następnie zmienisz konto z powrotem na usługę SIECIową na serwerze w nowej domenie. Baza danych konfiguracji jest hostowana na serwerze o nazwie ContosoMain w instancji o nazwie TeamDatabases w programie 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"

---

Zadania

Za pomocą polecenia zadań można utworzyć plik dziennika zawierający szczegółowe informacje o ostatnim działaniu zadania dla określonej kolekcji projektów lub ponowić próbę wykonania zadania dla jednej lub wszystkich kolekcji projektów.

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

Opcja	Opis
Ponów próbę	Wymagane, jeśli /dumplog nie jest używany. Określa, że najnowsza praca zostanie podjęta ponownie w określonej kolekcji projektów. Jeśli używasz tej opcji, musisz również użyć /CollectionName lub opcji /CollectionID.
dumplog	Wymagane, jeśli /retry nie jest używane. Określa, że najnowsza aktywność zadania związana z kolekcją zostanie wysłana do pliku dziennika. Jeśli używasz tej opcji, musisz również użyć opcji /CollectionName lub /CollectionID.
Nazwa Kolekcji	Wymagane, jeśli /CollectionID nie jest używany. Określa nazwę kolekcji, dla której najnowsze zadanie zostanie ponowione (/ponowić) lub zarejestrowane (/dumplog). Jeśli chcesz określić wszystkie kolekcje, możesz użyć gwiazdki (*).
Identyfikator kolekcji	Wymagane, jeśli /CollectionName nie jest używany. Określa numer identyfikacyjny kolekcji, dla której zostanie ponowione ostatnie zadanie (/ponów próbę) lub zarejestrowane (/dumplog).

Wymagania wstępne

Aby użyć polecenia 'jobs', musisz być członkiem grupy zabezpieczeń Administratorzy usługi Azure DevOps. Aby uzyskać więcej informacji, zobacz Referencję uprawnień dla usługi Azure DevOps Server.

Uwagi

Aby ponowić próbę zadania interaktywnie, otwórz konsolę administracyjną Azure DevOps, wybierz kartę Status dla kolekcji, a następnie wybierz Ponów próbę zadania. Aby uzyskać więcej informacji, zobacz Otwórz konsolę administracyjną usługi Azure DevOps.

Przykład

W poniższym przykładzie pokazano, jak utworzyć plik dziennika, który zawiera listę najnowszych działań związanych z zadaniem dla kolekcji projektów Contoso Summer Intern Projects w usłudze Azure DevOps Server.

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

---

Tryb offline odłącz

Użyj polecenia offlineDetach, aby przekształcić bazę danych kolekcji offline w odłączoną bazę danych kolekcji offline.

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

Opcja	Opis
configurationDB	Określa nazwę bazy danych konfiguracji, która ma być używana.
collectionDB	Określa nazwę bazy danych kolekcji do odłączenia.

Wymagania wstępne

Aby użyć polecenia offlineDetach, musisz być członkiem roli administratora systemu dla określonego wystąpienia programu SQL Server.

Uwagi

To polecenie modyfikuje schemat określonej bazy danych kolekcji i nigdy nie powinno być uruchamiane względem baz danych, które są używane przez instalację serwera Team Foundation Server. Jeśli bazy danych są używane przez wdrożenie serwera Team Foundation Server, użyj TfsConfig collection /detach zamiast tego.

To polecenie jest przydatne, gdy trzeba przywrócić pojedynczą bazę danych kolekcji z kopii zapasowej bez przywracania innych baz danych kolekcji, które są częścią tego samego wdrożenia usługi Azure DevOps Server. Wcześniej wymagane było przywrócenie kompletnego i spójnego zestawu baz danych (konfiguracji i wszystkich kolekcji) do środowiska przejściowego, skonfigurowanie wdrożenia usługi Azure DevOps Server przy użyciu tych baz danych i odłączenie jednej kolekcji zainteresowań.

Zamiast tego można teraz przywrócić spójne kopie bazy danych konfiguracji i bazy danych kolekcji, a następnie uruchomić offlineDetach polecenia. Odłączona baza danych kolekcji może być następnie dołączona do dowolnego wdrożenia usługi Azure DevOps Server w odpowiedniej wersji.

Przykład

Poniższy przykład pokazuje odłączanie bazy danych kolekcji o nazwie TFS_PrimaryCollection, używając bazy danych konfiguracji o nazwie TFS_Configuration, obie znajdują się w wystąpieniu SQL uruchomionym na serwerze o nazwie ContosoTemp, w nazwanym wystąpieniu Backups.

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

---

Proxy

Możesz użyć polecenia proxy , aby zaktualizować lub zmienić ustawienia używane przez serwer proxy usługi Azure DevOps. Serwer proxy usługi Azure DevOps zapewnia obsługę rozproszonych zespołów w celu korzystania z kontroli wersji przez zarządzanie pamięcią podręczną pobranych plików kontroli wersji w lokalizacji rozproszonego zespołu. Konfigurując serwer proxy usługi Azure DevOps, można znacznie zmniejszyć przepustowość wymaganą w przypadku połączeń na całym obszarze. Ponadto nie trzeba zarządzać pobieraniem i buforowaniem plików wersji; zarządzanie plikami jest niewidoczne dla dewelopera, który korzysta z plików. W międzyczasie wszystkie wymiany metadanych i przekazywanie plików będą nadal wyświetlane w usłudze Azure DevOps Server. Jeśli używasz usług Azure DevOps Services do hostowania projektu programistycznego w chmurze, możesz użyć polecenia proxy, aby nie tylko zarządzać pamięcią podręczną dla projektów w hostowanej kolekcji, ale także zarządzać niektórymi ustawieniami używanymi przez usługę.

Aby uzyskać więcej informacji na temat instalowania serwera proxy usługi Azure DevOps i początkowej konfiguracji serwera proxy,

Zobacz Instrukcje: instalowanie serwera proxy usługi Azure DevOps i konfigurowanie lokacji zdalnej. Aby uzyskać więcej informacji na temat konfigurowania serwera proxy na komputerach klienckich, zobacz Dokumentacja poleceń kontroli wersji usługi Azure DevOps.

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

Opcja	Opis
dodaj	Dodaje określony serwer lub kolekcję do listy serwerów proxy w pliku Proxy.config. Można uruchomić /add wiele razy, aby uwzględnić więcej kolekcji lub serwerów. W przypadku używania /add z kolekcją hostowaną w usługach Azure DevOps Services zostanie wyświetlony monit o podanie poświadczeń w usługach Azure DevOps Services.
zmieniać	Zmienia poświadczenia przechowywane w formie konta usługi dla Azure DevOps Services. /change opcja jest używana tylko dla usług Azure DevOps Services; nie należy jej używać w przypadku lokalnych wdrożeń usługi Azure DevOps Server.
usuń	Usuwa określony serwer lub kolekcję z listy serwerów proxy w pliku Proxy.config.
konto	Określa konto używane jako konto usługi dla serwera proxy w usługach Azure DevOps Services. Ta opcja jest używana tylko dla usług Azure DevOps Services w połączeniu z opcją /change. Domyślne konto usługi używane dla usług Azure DevOps Services to "Usługa konta".
Kontynuuj	Kontynuuje wykonywanie polecenia, nawet jeśli proces weryfikacji generuje ostrzeżenia.
Kolekcja	Określa adres URL kolekcji projektów hostowanej w usługach Azure DevOps Services w formacie AccountName.DomainName/CollectionName.
konto	Określa nazwę konta, które jest używane jako konto usługi dla usług Azure DevOps Services. Jeśli nazwa konta ma spacje, nazwa musi być ujęta w cudzysłów (""). Wszystkie znaki specjalne w nazwach kont muszą być określone zgodnie ze składnią wiersza polecenia.
konto	Określa adres URL wdrożenia usługi Azure DevOps Server w formacie ServerURL:Port/tfs.
PlikTokenuDostępuOsobistego	Opcjonalnie określa ścieżkę do pliku zawierającego osobisty token dostępu. Ten token będzie używany do uwierzytelniania w kolekcji lub koncie podczas rejestrowania serwera proxy. (Dodano w programie TFS 2018 Update 1)
Wejścia	Opcjonalny. Określa dodatkowe ustawienia i wartości do użycia podczas konfigurowania serwera proxy.! Na przykład wartości GvfsProjectName i GvfsRepositoryName mogą służyć do konfigurowania repozytorium Git do użycia z wirtualnym systemem plików Git (GVFS) (dodano w programie TFS 2018 Update 1)

Wymagania wstępne

Aby użyć polecenia proxy , musisz być członkiem grupy zabezpieczeń Administratorzy Azure DevOps i administratorem dla serwera proxy. Aby uzyskać więcej informacji, zobacz Dokumentacja uprawnień dla usługi Azure DevOps Server.

Uwagi

Aby zaktualizować istniejącą konfigurację Azure DevOps Server Proxy, użyj polecenia proxy . Do początkowej instalacji i konfiguracji serwera proxy nie można użyć polecenia serwera proxy.

Przykłady

W poniższym przykładzie pokazano, jak dodać wdrożenie usługi Azure DevOps Server o nazwie FABRIKAM do listy serwerów proxy.

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

W poniższym przykładzie pokazano, jak dodać kolekcję projektów hostowaną w usługach Azure DevOps Services do listy serwerów proxy przy użyciu osobistego tokenu dostępu w celu uwierzytelnienia. Ten token będzie używany tylko do rejestrowania serwera proxy przy użyciu konta usługi Azure DevOps Services — domyślne konto usługi będzie nadal używane do uruchamiania serwera proxy. Ten parametr został dodany w programie TFS 2018 Update 1 w celu obsługi rejestrowania serwera proxy w usłudze Azure DevOps Services bez konieczności monitu logowania.

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

W poniższym przykładzie pokazano, jak dodać kolekcję projektów do listy serwerów proxy. W tym przykładzie użyto osobistego tokenu dostępu do uwierzytelniania w kolekcji określonej przy użyciu parametru /Collection. Osobisty token dostępu do użycia jest zapisywany w pliku w c:\PersonalAccessToken.txt.

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

W poniższym przykładzie pokazano, jak zmienić konto usługi używane przez serwer proxy dla kolekcji projektów hostowanej w usługach Azure DevOps Services. Kolekcja nosi nazwę PhoneSaver, nazwa konta używana dla usług Azure DevOps Services jest HelenaPetersen.fabrikam.com, a konto usługi używane przez serwer proxy jest zmieniane na My Proxy Service Account. Ponieważ nazwa konta zawiera spacje, znaki cudzysłowu są używane do ujęć nazwę.

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

W poniższym przykładzie pokazano, jak dodać repozytorium Git do użycia z systemem GVFS.

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

---

RebuildWarehouse

Za pomocą polecenia rebuildWarehouse można ponownie skompilować bazy danych usług SQL Server Reporting Services i SQL Server Analysis Services używane przez usługę Azure DevOps Server.

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

Opcja	Opis
analysisServices	Wymagane, jeśli /all nie jest używany. Określa, że tylko baza danych dla usług Analysis Services zostanie ponownie skompilowana. Jeśli dla usług Analysis Services nie istnieje żadna baza danych, należy również użyć opcji /reportingDataSourcePassword.
wszystkie	Wymagane, jeśli /analysisServices nie jest używany. Określa, że wszystkie bazy danych raportowania i analizy używane przez usługę Azure DevOps Server zostaną ponownie skompilowane.
hasłoŹródłaDanychRaportowania	Wymagane, jeśli baza danych TFS_Analysis nie istnieje. Określa hasło konta, które jest używane jako konto źródeł danych dla usług SQL Server Reporting Services (TFSReports). Aby uzyskać więcej informacji, odnieś się do Konta usług i zależności w usłudze Azure DevOps Server.

Wymagania wstępne

Aby użyć polecenia rebuildWarehouse, musisz być członkiem następujących grup:

• Grupa zabezpieczeń Administratorzy usługi Azure DevOps i administratorzy na serwerze lub serwerach z uruchomioną konsolą administracyjną usługi Azure DevOps

• Grupa administratorów systemu zarządzająca serwerem lub serwerami z uruchomionym wystąpieniem SQL Server, które hostuje bazy danych dla usługi Azure DevOps Server.

Aby uzyskać więcej informacji, zobacz Referencja uprawnień dla Azure DevOps Server.

Uwagi

To polecenie można użyć podczas przenoszenia lub dzielenia kolekcji projektów, przywracania danych lub zmiany konfiguracji wdrożenia.

Aby interaktywnie uruchomić ponowne kompilowanie tych baz danych, możesz użyć węzła Raportowanie w konsoli administracyjnej usługi Azure DevOps. Aby uzyskać więcej informacji, zobacz Otwórz konsolę administracyjną usługi Azure DevOps.

Przykład

W poniższym przykładzie pokazano, jak ponownie skompilować bazę danych usług Analysis Services na potrzeby wdrożenia serwera Azure DevOps Server.

TfsConfig rebuildWarehouse /analysisServices

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

---

RejestrDB

Użyj registerDB, aby zaktualizować nazwę serwera, który hostuje bazę danych konfiguracji w usłudze Azure DevOps Server. To polecenie można użyć podczas przywracania bazy danych konfiguracji do nowego sprzętu lub zmiany domeny wdrożenia.

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

Opcja	Opis
SqlInstance	To jest wymagane. Określa nazwę serwera z uruchomionym programem SQL Server i nazwę wystąpienia, jeśli chcesz użyć wystąpienia innego niż wystąpienie domyślne. Jeśli określisz wystąpienie, musisz użyć formatu: ServerName\InstanceName.
nazwaBazyDanych	To jest wymagane. Określa nazwę bazy danych konfiguracji. Domyślnie jest to Tfs_Configuration.

Wymagania wstępne

Aby użyć polecenia registerDB, musisz być członkiem grupy Administratorzy usługi Azure DevOps na serwerze warstwy aplikacji i członkiem grupy sysadmin w programie SQL Server na serwerze warstwy danych dla usługi Azure DevOps. Aby uzyskać więcej informacji, zobacz Dokumentacja uprawnień dla usługi Azure DevOps Server.

Uwagi

Przed użyciem tego polecenia należy utworzyć kopię zapasową baz danych dla usługi Azure DevOps Server.

Aby polecenie registerDB powiodło się, należy uruchomić następujące pule aplikacji i programy:

• Pula aplikacji serwera Usługi Azure DevOps (pula aplikacji)
• ReportServer (pula aplikacji)
• SQL Server Reporting Services (program)

Aby to polecenie działało poprawnie, należy podać dokładną nazwę lub adres bazy danych konfiguracji. Jeśli musisz zmienić serwer, na którym jest przechowywana ta baza danych, musisz upewnić się, że serwer Usługi Azure DevOps wskazuje nową lokalizację.

Przykład

Poniższy przykład przekierowuje usługę Azure DevOps Server do bazy danych konfiguracji znajdującej się na serwerze ContosoMain w wystąpieniu programu SQL Server TeamDatabases.

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

---

Ponowne mapowanie baz danych

Polecenie remapDBs przekierowuje serwer Azure DevOps Server do jego baz danych, gdy są przechowywane na więcej niż jednym serwerze i przywracasz, przenosisz lub w inny sposób zmieniasz konfigurację wdrożenia. Na przykład należy przekierować serwer Azure DevOps Server do dowolnych baz danych dla kolekcji projektów, jeśli są one hostowane na osobnym serwerze lub serwerach z bazy danych konfiguracji. Należy również przekierować Azure DevOps Server na serwer lub serwery, na których są uruchomione usługi SQL Server Analysis Services lub SQL Server Reporting Services, jeśli te bazy danych są hostowane na osobnym serwerze lub instancji niż baza danych konfiguracji.

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

Opcja	Opis
Nazwa bazy danych	Określa nazwę serwera, który hostuje bazę danych, którą chcesz mapować dla serwera Azure DevOps Server, oprócz nazwy samej bazy danych.
Wystąpienia SQL	Określa nazwę serwera, na którym działa program SQL Server, oprócz nazwy wystąpienia, jeśli chcesz użyć wystąpienia innego niż wystąpienie domyślne. Jeśli określasz więcej niż jeden serwer, musisz użyć przecinka, aby oddzielić wiele par serwerów i nazw wystąpień.
Instancja Analizy	Opcjonalny. Określa konkretnie nazwę serwera i wystąpienia, które hostują usługi SQL Server Analysis Services. Użyj tej opcji, aby określić serwer i wystąpienie hostujące bazę danych usług Analysis Services.
NazwaBazyDanychAnalizy	Opcjonalny. Określa nazwę bazy danych usług Analysis Services, która ma być używana z usługą Azure DevOps Server, jeśli na serwerze określonym przy użyciu opcji /AnalysisInstance istnieje więcej niż jedna taka baza danych.
podgląd	Opcjonalny. Wyświetla akcje, które należy wykonać, aby zaktualizować konfigurację.
kontynuować	Opcjonalny. Określa, że polecenie RemapDB powinno być kontynuowane nawet w przypadku wystąpienia błędu podczas próby zlokalizowania co najmniej jednej bazy danych. Jeśli używasz opcji /continue, kolekcje, których bazy danych nie zostaną znalezione na serwerze lub serwerach, które wskażesz, zostaną ponownie skonfigurowane do używania serwera i wystąpienia, które hostują bazę danych konfiguracji.

Wymagania wstępne

Aby użyć polecenia remapDBs, musisz być członkiem grupy zabezpieczeń Administratorzy usługi Azure DevOps i członkiem grupy zabezpieczeń sysadmin dla wszystkich baz danych programu SQL Server używanych przez usługę Azure DevOps Server. Aby uzyskać więcej informacji, zobacz Dokumentacja uprawnień dla usługi Azure DevOps Server.

Uwagi

Użyj polecenia remapDBs, aby ponownie skonfigurować serwer Azure DevOps Server do używania różnych serwerów i wystąpień programu SQL Server zamiast serwerów i wystąpień z oryginalnej instalacji.

Przykład

W poniższym przykładzie pokazano, jak przekierować serwer Azure DevOps Server do bazy danych konfiguracji TFS_Configuration. Ta baza danych jest hostowana na ContosoMain w wystąpieniu o nazwie TeamDatabases. Bazy danych kolekcji projektów są przechowywane zarówno w ContosoMain\TeamDatabases, jak i w wystąpieniu domyślnym Contoso2.

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

---

KolejkaZadańNaprawczych

Użyj polecenia repairJobQueue, aby naprawić zaplanowane zadania, które przestały działać dla hostów wdrożeń i kolekcji.

TfsConfig repairJobQueue

Wymagania wstępne

Aby użyć polecenia repairJobQueue, musisz być członkiem lokalnej grupy administratorów na maszynie z systemem TfsConfig. Musisz również być członkiem roli zabezpieczeń sysadmin dla wszystkich wystąpień programu SQL Server używanych przez wdrożenie usługi Azure DevOps Server.

Uwagi

Zazwyczaj należy użyć polecenia repairJobQueue, jeśli zauważysz, że zaplanowane zadania nie są uruchomione.
Polecenie nie bierze żadnych argumentów i wymaga skonfigurowania wdrożenia usługi Azure DevOps Server.

Przykład

TfsConfig repairJobQueue

---

Ustawienia

Polecenia można używać z ustawieniami w celu zautomatyzowania zmian w ujednoliconym lokalizatorze zasobów (URL), który jest wykorzystywany przez interfejs powiadomień oraz w adresie serwera dla Azure DevOps Server. Domyślnie adres URL interfejsu powiadomień i adres URL serwera są zgodne w usłudze Azure DevOps Server, ale można skonfigurować oddzielne adresy URL. Na przykład możesz użyć innego adresu URL dla automatycznych wiadomości e-mail generowanych przez usługę Azure DevOps Server. To narzędzie należy uruchomić z warstwy aplikacji, aby zaktualizować wszystkie serwery, aby używały nowych adresów URL.

Aby interaktywnie zmienić te adresy URL lub po prostu wyświetlić bieżące ustawienia, możesz użyć konsoli administracyjnej usługi Azure DevOps. Zobacz Szybkie informacje o zadaniach administracyjnych.

TfsConfig settings [/publicURL:URL]

Opcja	Opis
publicUrl	Określa adres URL serwera warstwy aplikacji dla usługi Azure DevOps. Ta wartość jest przechowywana w bazie danych konfiguracji dla usługi Azure DevOps.

Wymagania wstępne

Musisz być członkiem grupy zabezpieczeń Administratorzy usługi Azure DevOps i grupy Administratorzy na serwerze warstwy aplikacji. Aby uzyskać więcej informacji, zobacz Ustawianie uprawnień administratora dla usługi Azure DevOps Server.

Uwagi

Ustawienia polecenia zmieniają informacje o połączeniu dla komunikacji serwer-serwer we wdrożeniu usługi Azure DevOps Server. Adres URL określony w /publicURL musi być dostępny dla wszystkich serwerów we wdrożeniu.

Przykład

Poniższy przykład zmienia wartość notificationURL na http://contoso.example.com/tfs i wartość ServerURL na http://contoso.example.com:8080/tfs.

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

---

Konfiguracja

Aby odinstalować funkcje, które są obecnie skonfigurowane na maszynie, na której jest uruchamiane polecenie, należy użyć polecenia setup.

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

Opcja

Opis

/odinstaluj

Określa co najmniej jedną funkcję do odinstalowania z komputera, na którym jest uruchamiane polecenie. Dostępne opcje to: Wszystkie, ApplicationTier, Search i VersionControlProxy.

Wymagania wstępne

Aby użyć polecenia setup, musisz być członkiem grupy zabezpieczeń Administratorzy usługi Azure DevOps.

Przykłady

Poniższy przykład odinstalowuje wszystkie funkcje usługi Azure DevOps Server z bieżącej maszyny.

TfsConfig setup /uninstall:All

Poniższy przykład odinstalowuje warstwę aplikacji i funkcje kompilacji z bieżącej maszyny.

TfsConfig setup /uninstall:ApplicationTier 

---

TCM

Podczas uaktualniania do najnowszej wersji usługi Azure DevOps Server system automatycznie próbuje uaktualnić składniki zarządzania testami, w tym plany testów i zestawy.

Jeśli migracja automatyczna nie powiedzie się, użyj polecenia TCM, aby uaktualnić plany testów i zestawy testów ręcznie do odpowiednich typów elementów roboczych (WIT).

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

Opcja

Opis

/upgradeTestPlans

Wymagane, chyba że użyto /upgradeStatus.

Konwertuje istniejący plan testów i zestawy testów, aby wskazać plany testów oparte na elementach roboczych i zestawy testów. Aktualizuje również istniejące dane zarządzania testami i linki między innymi istniejącymi artefaktami testowymi, takimi jak punkty testów, przebiegi testów i wyniki testów.

/upgradeStatus

Wymagane, chyba że używany jest /upgradeTestPlans.

Raportuje stan migracji danych testowych dla określonego projektu. Będzie również wskazywać, czy określony projekt ma jakiekolwiek plany testów.

/CollectionName:CollectionName

To jest wymagane. Określa kolekcję projektów zawierającą projekt, dla którego chcesz przeprowadzić migrację danych testowych lub sprawdź stan migracji.

Jeśli w nazwie kolekcji projektu znajdują się spacje, podaj nazwę w cudzysłowie, na przykład "Fabrikam Fiber Collection".

/TeamProjectName:TeamProjectName

To jest wymagane. Określa projekt, dla którego chcesz przeprowadzić migrację danych testowych lub sprawdź stan migracji. Ten projekt musi być zdefiniowany w kolekcji określonej przy użyciu parametru /collectionName.

Jeśli w nazwie projektu znajdują się spacje, podaj nazwę w cudzysłowie, na przykład "Mój projekt".

Wymagania wstępne

Musisz być członkiem grupy zabezpieczeń Administratorzy programu Team Foundation i administratorem na serwerze warstwy aplikacji.

Zobacz Ustawianie uprawnień administratora dla usługi Azure DevOps Server.

Uwagi

Aby można było użyć tego polecenia, serwer warstwy aplikacji musi zostać uaktualniony do najnowszej wersji usługi Azure DevOps Server 2019.

Przed użyciem polecenia TCM należy najpierw zaimportować definicję elementu roboczego planu testu i kategorię planu testu do projektu.

Aby dowiedzieć się więcej o migracji i korzystaniu z tego polecenia, zobacz Ręczne aktualizacje do obsługi zarządzania testami.

Polecenie TCM jest stosowane do poszczególnych projektów. Jeśli musisz uaktualnić plany testów w więcej niż jednym projekcie, musisz uruchomić go osobno dla każdego projektu.

Należy uruchomić polecenie TCM z katalogu narzędzi dla usługi Azure DevOps Server. Domyślnie ta lokalizacja to: drive:\%programfiles%\TFS 12.0\Tools.

Użyj polecenia TCM tylko w przypadku niepowodzenia automatycznej migracji istniejących danych testowych.

Aby dowiedzieć się więcej o migracji i kiedy używać tego polecenia, ręczne aktualizacje wspomagające zarządzanie testami. Jeśli nie możesz uzyskać dostępu do planów testów lub zestawów testów zdefiniowanych przed uaktualnieniem serwera, uruchom tfSConfig TCM upgradeStatus, aby określić stan migracji.

Uruchamiasz polecenie TCM dla pojedynczego projektu. Jeśli musisz uaktualnić więcej niż jeden projekt, musisz uruchomić go dla każdego projektu z kolei.

Przykłady

W poniższym przykładzie pokazano, jak sprawdzić stan uaktualnienia planu testowego w projekcie Fabrikam Fiber hostowanym w domyślnej kolekcji projektów (DefaultCollection):

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

---

Nienadzorowane

Dostępność poleceń: Azure DevOps Server 2019

Polecenie nienadzorowane jest przeznaczone dla użytkowników, którzy znają usługę Azure DevOps Server i proces konfiguracji oraz którzy muszą zainstalować serwer Azure DevOps Server na różnych komputerach.

Jeśli na przykład używasz usługi Azure DevOps Build, możesz użyć nienadzorowanego polecenia , aby zainstalować wiele serwerów kompilacji za pomocą tego samego pliku konfiguracji.

Użyj opcji /create, aby utworzyć plik nienadzorowany. Ten plik definiuje wszystkie parametry konfiguracji instalacji usługi Azure DevOps Server. Następnie użyj opcji /configure, aby rzeczywiście wykonać konfigurację.

Ten proces umożliwia skonfigurowanie serwera Azure DevOps Server od początku do końca bez konieczności podawania danych wejściowych podczas procesu instalacji. W przypadku wielu instalacji pomaga to również zapewnić, że dokładnie te same parametry konfiguracji są używane na wielu serwerach.

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

Opcja	Opis
utwórz	Tworzy plik nienadzorowany o określonej nazwie i parametrach.
konfigurować	Konfiguruje usługę Azure DevOps Server przy użyciu pliku unattend i określonych przez Ciebie parametrów. Należy użyć /type lub /unattendfile z tą opcją.
typ	Określa typ konfiguracji do użycia. Jeśli używasz /configure, /type lub /unattendfile są wymagane, ale nie można użyć obu.
plik unattendfile	Określa plik nienadzorowany do utworzenia lub użycia, w zależności od tego, czy początkowy parametr to /create, czy /configure. Jeśli używasz /configure, /unattendfile lub /type są wymagane.
Wejścia	Opcjonalny. Jeśli używasz /create, określa ustawienia i wartości do użycia podczas tworzenia pliku nienadzorowanego. Jeśli używasz /configure, określa dodatkowe ustawienia i wartości do użycia w połączeniu z nienadzorowanym plikiem. Alternatywą dla używania /inputs jest ręczne edytowanie pliku nienadzorowanego w dowolnym edytorze zwykłego tekstu. Jest to konieczne w przypadku niektórych typów wejściowych, takich jak ServiceAccountPassword lub PersonalAccessToken, ponieważ nie można ustawić tych wartości tajnych przy użyciu parametru /inputs.
zweryfikować	Opcjonalny. Określa przebieg konfiguracji, który wykonuje tylko kontrole weryfikacji na podstawie pliku nienadzorowanego, danych wejściowych i typu konfiguracji. Jest to alternatywa dla wykonania pełnej konfiguracji.
kontynuować	Opcjonalny. Określa, że /create lub /configure powinny być kontynuowane niezależnie od ostrzeżeń wynikających z przeprowadzanych w ramach kontroli weryfikacyjnych.

Typ instalacji	Opis
NewServerBasic	Konfiguruje podstawowe usługi programistyczne dla usługi Azure DevOps Server. Obejmuje to kontrolę źródła, elementy robocze, kompilację i opcjonalnie wyszukiwanie.
NewServerAdvanced	Konfiguruje podstawowe usługi programistyczne i umożliwia opcjonalną konfigurację integracji z usługami Reporting Services.
Modernizacja	Uaktualnia serwer Azure DevOps do bieżącej wersji z poprzedniej obsługiwanej wersji.
PreProductionUpgrade	Przetestuj uaktualnienie w istniejącym wdrożeniu usługi Azure DevOps Server w środowisku przedprodukcyjnym. Zazwyczaj odbywa się to przy użyciu baz danych przywróconych z kopii zapasowych produkcyjnych. Ten scenariusz zawiera dodatkowe kroki, aby upewnić się, że nowe wdrożenie nie będzie zakłócać wdrażania produkcyjnego.
ApplicationTierOnlyBasic	Skonfiguruj nową warstwę aplikacji przy użyciu istniejących ustawień z podanej bazy danych konfiguracji. Ta opcja umożliwia szybkie uruchamianie nowej warstwy aplikacji przy użyciu istniejących ustawień. Jeśli chcesz zmienić istniejące ustawienia, zamiast tego użyj typu Advanced ApplicationTierOnlyAdvanced.
PoziomAplikacjiTylkoZaawansowany	Skonfiguruj nową warstwę aplikacji z pełną kontrolą nad wszystkimi ustawieniami. Ustawienia będą domyślne dla istniejących wartości z podanej bazy danych konfiguracji. Jeśli chcesz zachować wszystkie istniejące ustawienia, zamiast tego użyj typu ApplicationTierOnlyBasic.
Klon	Skonfiguruj nowe wdrożenie usługi Azure DevOps Server, które jest klonem istniejącego wdrożenia. Zazwyczaj odbywa się to przy użyciu baz danych przywróconych z kopii zapasowych produkcyjnych, aby utworzyć środowisko, w którym można przetestować zmiany konfiguracji, rozszerzenia i inne modyfikacje. Ten scenariusz zawiera dodatkowe kroki, aby upewnić się, że nowe wdrożenie nie będzie zakłócać wdrażania produkcyjnego.
Proxy	Konfiguruje usługę proxy kontroli wersji.

Wymagania wstępne

• Musisz być członkiem grupy Administratorzy na komputerze, na którym instalujesz oprogramowanie.

• W zależności od typu instalacji może być również wymagane dodatkowe uprawnienia administratora.

Jeśli na przykład używasz polecenia unattend w celu zainstalowania Azure DevOps Server, musisz być członkiem grupy sysadmin w instancji SQL Server, która będzie obsługiwać Azure DevOps Server. Aby uzyskać więcej informacji, zobacz sekcję Q & A Dodawanie administratorów na poziomie serwera do usługi Azure DevOps Server.

Uwagi

Przed użyciem polecenia nienadzorowanego do skonfigurowania usługi Azure DevOps Server należy utworzyć konta usług, które będą używane w ramach wdrożenia. Należy również zainstalować dowolne wymagane oprogramowanie wstępne dla wybranego typu instalacji. Obejmuje to sam serwer Usługi Azure DevOps. Musisz zainstalować Azure DevOps Server, ale nie musisz go konfigurować, ponieważ polecenie unattended zrobi to za Ciebie.

Polecenie unattend konfiguruje składniki usługi Azure DevOps Server. Nie wykonuje początkowej instalacji oprogramowania. Konfiguruje oprogramowanie zgodnie z twoimi specyfikacjami, gdy dane są już obecne na komputerze.

Przykłady

W poniższym przykładzie pokazano, jak utworzyć plik nienadzorowany na potrzeby podstawowej instalacji usługi Azure DevOps Server.

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

W tym przykładzie plik nienadzorowany jest tworzony w tym samym katalogu co polecenie. Plik dziennika jest tworzony w ramach polecenia, a lokalizacja pliku jest zwracana w poleceniu w ramach wykonywania polecenia.

W poniższym przykładzie pokazano, jak określić repozytorium Git do użycia z systemem GVFS podczas konfiguracji.

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

W poniższym przykładzie pokazano, jak utworzyć plik nienadzorowany na potrzeby konfiguracji serwera proxy usługi Azure DevOps.

Ważne

W tym przykładzie, jeśli administratorzy chcą użyć osobistego tokenu dostępu do uwierzytelniania, będą musieli ręcznie edytować plik, aby określić wartość osobistego tokenu dostępu. Można to osiągnąć, dodając wiersz dla osobistego tokenu dostępu w utworzonym pliku nienadzorowanym, takim jak: PersonalAccessToken=PersonalAccessTokenValue.

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

W poniższym przykładzie pokazano, jak utworzyć plik nienadzorowany dla konfiguracji kompilacji serwera Azure DevOps Server na serwerze przy użyciu FabrikamFiber\BuildSVC jako konta usługi kompilacji, a następnie skonfigurować kompilację usługi Azure DevOps Server przy użyciu tego pliku nienadzorowanego.

Ważne

W tym przykładzie po utworzeniu pliku nienadzorowanego administrator ręcznie edytuje plik, aby określić hasło dla konta usługi kompilacji. Dodanie hasła jako danych wejściowych przy użyciu ServiceAccountPassword=PasswordPlaceholder; nie powoduje dodania informacji o haśle do pliku.

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

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

Pierwsze polecenie zwraca następujące:

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

Drugie polecenie zwraca następujące informacje, w tym nazwę serwera, na którym skonfigurowano usługę Azure DevOps Build FabrikamFiberTFS i kolekcję projektów skojarzona z kontrolerem DefaultCollection:

    Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
    Copyright (c) Microsoft Corporation. All rights reserved.

    Command: unattend

    ---------------------------------------------
            Inputs:
    ---------------------------------------------

    Feedback
            Send Feedback: True

    Build Resources
            Configuration Type: create
            Agent Count: 1
            New Controller Name: FabrikamFiberTFS - Controller
            Clean Up Resources: False

    Project Collection
            Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

    Windows Service
            Service Account: FabrikamFiber\BuildSVC
            Service Password: ********

    Advanced Settings *
            Port: 9191

    ---------------------------------------------
            Running Readiness Checks
    ---------------------------------------------

    [1/2] System Verifications
    [2/2] Build Service Verifications

    ---------------------------------------------
            Configuring
    ---------------------------------------------

            root
    [1/4] Install Team Foundation Build Service
            Installing Windows services ...
            Adding service account to groups ...
            Setting ACL on a windows service
    [2/4] Enable Event Logging
            Adding event log sources ...
            Token replace a config file
            RegisterBuildEtwProvider
            Configuring ETW event sources ...
    [3/4] Register with Team Foundation Server
            Registering the build service
    [4/4] Start Team Foundation Build Service
            StartBuildHost
            Starting Windows services ...
            Marking feature configured status
    [Info] [Register with Team Foundation Server] Firewall exception added for port
    9191

    TeamBuild completed successfully.
    Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

---

ZipLogs

Polecenie ziplogs jest przeznaczone do zbierania logów i zapisuje plik zip w ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

---