Použití TFSConfig ke správě Azure DevOps místně

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

Nástroj příkazového řádku TFSConfig můžete použít k provádění různých akcí správy pro místní nasazení Azure DevOps.

TFSConfig je možné spustit z libovolného počítače, na kterém je nainstalovaný Azure DevOps Server.

Umístění nástroje příkazového řádku

Nástroje příkazového řádku Azure DevOps se instalují do adresáře /Tools serveru aplikační vrstvy 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

Požadavky

Aby mnoho příkazů fungovalo správně, bude potřeba, aby se TFSConfig mohl připojit k různým serverům a službám, které jsou součástí vašeho nasazení SADY TFS, a uživatel, který spouští TFSConfig , musí mít oprávnění správce pro tyto stejné servery a služby. Níže budou uvedeny požadavky na konkrétní příkazy.

Mnoho příkazů TFSConfig musí být spuštěno z příkazového řádku se zvýšenými oprávněními, i když má spuštěný uživatel přihlašovací údaje správce. Chcete-li otevřít příkazový řádek se zvýšenými oprávněními, klepněte na tlačítko Start, klepněte pravým tlačítkem myši na příkazový řádek a klepněte na příkaz Spustit jako správce. Další informace najdete v tématu: Řízení uživatelských účtů.

Akce správy můžete také interaktivně provádět pomocí konzoly pro správu pro Azure DevOps Server. Podívejte se na stručnou příručku k administrativní úloze.

Výpis příkazů a získání nápovědy

Pokud chcete zobrazit úplný seznam příkazů TFSConfig , použijte příkaz nápovědy :

TFSConfig help

Pokud chcete získat nápovědu pro jednotlivé příkazy, použijte příkaz nápovědy a zadejte název příkazu, se kterým chcete pomoct. Pokud například chcete získat nápovědu pro příkaz účty :

TFSConfig help accounts

Účty

Pomocí příkazu accounts můžete spravovat tyto účty služby Azure DevOps Server.

účet služby Azure DevOps Server
zdroje dat pokrývají službu SQL Server Reporting Services
účet služby proxy serveru Azure DevOps

Pomocí tohoto příkazu můžete také změnit vlastnictví databází Azure DevOps Serveru.

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

Operace	Popis
Aktualizovat heslo	Změní heslo účtu, který se používá jako účet služby. Změní existující účet a všechny typy účtů, které běží jako daný účet.
Změna	Změní účet, který se používá jako účet služby. Přidá nový účet k potřebným prostředkům a skupinám, udělí požadovaná oprávnění a pak nastaví službu tak, aby ji používala. Tím se neodebere starý účet z prostředků. Pokud možnost accountType nepoužíváte, účet služby pro aplikační vrstvu se změní.
Přidej	Nový účet se přidává pouze k nezbytným prostředkům. Užitečné pro scénáře NLB. Příznak pokračování použijte, pokud některé kolekce nejsou dostupné. Přidání můžete spustit znovu později, aby se aktualizovaly všechny zmeškané kolekce. Přidá účet do skupin, které jsou potřeba pro použití účtu jako účtu služby.
Nastavit	Nastaví službu tak, aby používala účet, který již byl přidán k prostředkům. Užitečné pro scénáře NLB.
Vymazat	Odebere účet ze všech prostředků. Při odstraňování účtu by se měla použít bezpečnostní opatření, protože může způsobit odepření služby u jiných serverů.
Obnovit vlastníka	Pokud se databáze obnoví v rámci přesunu, klonování nebo zotavení po havárii, může vlastník databáze přepnout na správce obnovující server. Tato možnost iteruje všechny databáze a nastaví přihlášení dbo k aktuálnímu vlastníkovi.

Typ účtu	Popis
AdminConsole	Uživatelé konzoly pro správu jsou uživatelé, kteří mají udělená minimální oprávnění k používání konzoly v různých prostředcích.
aplikační vrstva	Změní účet služby v aplikačním fondu pro základní webové služby. (TFSService)
Zprostředkovatel	Změní účet služby na fondu aplikací pro webové služby proxy. (TFSProxy)
ZdrojDatProZprávy	Změní účet používaný sestavami pro přístup k datům pro vykazování. (TFSReports)

Výchozí hodnota je ApplicationTier.

SqlInstance a databaseName jsou vhodné pouze pro použití při přidávání účtu do databází před nakonfigurování aplikační vrstvy. To je primárně užitečné ve scénářích zotavení po havárii, ve kterých je před spuštěním průvodce konfigurací AT Only potřeba jiný účet.

Možnost pokračovat se používá při přidávání nebo změně účtu. Při těchto operacích se účet změní v databázi každé kolekce. Pokud je zadána možnost pokračování, bude pokračovat, pokud je kolekce nedostupná. Můžete to spustit znovu, až budou dostupné.

Poznámka:

Účty musí být ve formátu domainName\userName. U systémových účtů musíte použít uvozovky kolem úplného názvu účtu (například NT Authority\Network Service). Systémové účty nevyžadují heslo.

Parametr	Popis
Účet	Určuje název účtu, který chcete přidat, změnit nebo odstranit z odkazovaného typu účtu, například /AccountType:ApplicationTier.
Heslo	Určuje heslo účtu služby. Tento parametr je nepovinný, pokud používáte systémový účet nebo účet, který nemá heslo, jako je síťová služba.
sqlInstance	Používá se pouze s /ResetOwner. Určuje název serveru, na kterém běží SQL Server, a název instance, pokud chcete použít jinou instanci než výchozí instanci. Název a instanci musíte zadat v následujícím formátu: Název_serveru\InstanceName.
název databáze	Používá se pouze s /ResetOwner. Určuje název databáze, jejíž vlastnictví chcete změnit. Pomocí tohoto příkazu obnovíte vlastnictví databáze, kterou zadáte, na účet, pod kterým příkaz spouštíte.
pokračovat	Aktualizuje všechny skupiny, které nejsou při spuštění příkazu k dispozici. Tato možnost se obvykle používá ve scénářích nlB.

Požadavky

Pokud chcete použít příkaz účty , musíte být členem:

skupina zabezpečení Azure DevOps Administrators
role správce systému pro všechny instance SQL Serveru, které vaše instance Azure DevOps Serveru používá.

Pokud používáte možnost /proxy , musíte být správcem na proxy serveru.

Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Pomocí příkazu accounts můžete automatizovat změny účtů služeb, databází a skupin účtů služeb Azure DevOps Serveru. Můžete nakonfigurovat účty, které jste už vytvořili, ale nemůžete vytvářet účty.

Než změníte doménu nebo pracovní skupinu účtu, musí mít na serveru aplikační vrstvy oprávnění "Účet je citlivý a nelze jej delegovat". Další informace naleznete na této stránce na webu společnosti Microsoft: Povolení delegovaného ověřování.

Příkaz accounts podporuje místní nasazení Azure DevOps Serveru. Pokud chcete změnit vlastníka účtu Azure DevOps Services, přečtěte si téma Změna vlastnictví účtu.

Příklady

Změňte účet služby zdrojů dat pro Službu Reporting Services na nový účet v doméně Contoso\NewAccountContoso a heslo na Password.

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

Přidejte systémový účet síťové služby do skupin účtů služby pro Azure DevOps Server (systémové účty nemají hesla).

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

Změňte vlastnictví TFS_Warehouse databáze na ContosoMain SQL Serveru v TeamDatabases pojmenované instanci na uživatelský účet, pod kterým spouštíte příkaz.

Poznámka:

Při použití tohoto příkazu nemůžete určit, jaký účet se má nastavit jako vlastník databází. Vlastník bude nastaven na účet, pod kterým spouštíte příkaz.

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

PřidatProjektovéZprávy

Poznámka:

Příkaz addProjectReports je k dispozici v TFS 2017.1 a novějších verzích.

Příkaz addProjectReports slouží k přidání nebo přepsání sestav pro existující týmový projekt.

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

Možnost	Popis
kolekce	Povinné. Adresa URL kolekce týmových projektů
týmový projekt	Povinné. Určuje název týmového projektu.
šablona	Povinné. Určuje název šablony procesu. Dostupné možnosti jsou agilní, CMMI a Scrum.
síla	Volitelný. Určuje, že by se zprávy měly přepsat, pokud už existují.

Požadavky

Chcete-li použít příkaz addProjectReports , musíte mít oprávnění ke spuštění TFSConfig a k nahrání sestav do služby Reporting Service.

Poznámky

Příkaz addProjectReports použijete, pokud projekt nemá sestavy nebo chcete aktualizovat sestavy definované pro proces.

Tento příkaz možná budete muset použít v těchto případech:

Projekt byl vytvořen na portálu Azure DevOps, a ne ze sady Visual Studio.
Projekt byl vytvořen ze sady Visual Studio, ale generování sestav nebylo nakonfigurováno na Azure DevOps Serveru.

Pokud jste upgradovali Azure DevOps Server a staré sestavy ve vašem projektu už nejsou kompatibilní, použijte možnost /force pro přepsání těchto sestav výchozími sestavami. Pokud jste sestavy přizpůsobili, proveďte zálohu, než to uděláte.

Další informace o přidávání sestav do místního Azure DevOps Serveru najdete v tématu Přidání sestav do projektu.

Příklad

Následující příklad ukazuje, jak přidat Agile sestavy do projektu MyProject v kolekci projektů http://myTfsServer:8080/tfs/DefaultCollection.

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

Autentizace

Příkaz Ověřování změní protokol ověřování sítě, který používá aplikační vrstva serveru Azure DevOps Server nebo web proxy serveru.

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

Možnost

popis

/viewAll

Zobrazí aktuální nastavení ověřování pro Azure DevOps Server.

/poskytovatel: { NTLM | Negotiate }

Určuje zprostředkovatele ověřování, kterého chcete pro web nakonfigurovat.

NTLM: Použití ověřovacího protokolu NTML
Negotiate: Použití ověřovacího protokolu Negotiate (Kerberos)

/siteType

Určuje web (aplikační vrstvu nebo proxy server), jehož protokol pro ověřování sítě chcete změnit. Aplikační úroveň je výchozí.

Požadavky

Pokud chcete použít příkaz Ověřování , musíte být členem skupiny zabezpečení Azure DevOps Administrators a místního správce na serveru aplikační vrstvy nebo proxy serveru v závislosti na hodnotě možnosti siteType .

Poznámky

Příkaz Ověřování používá správce, který chce změnit protokol ověřování sítě pro jeden nebo více webů, na kterých azure DevOps Server spoléhá. Správce spustí tento příkaz z aplikační vrstvy, aby aktualizoval weby, které vyžadují změnu v protokolu ověřování sítě. Příkaz změní vlastnost NTAuthenticationProviders v metabáze služby IIS.

Než použijete příkaz Ověřování ke změně ověřovacího protokolu, můžete příkaz spustit pomocí možnosti /viewAll a zjistit, co jsou stávající nastavení.

Příklad

Následující příklad zobrazí aktuální hodnotu, která je přiřazena pro protokol ověřování sítě.

TFSConfig Authentication /viewAll

Certifikáty

Pomocí příkazu certifikáty můžete změnit způsob konfigurace certifikátů pro ověřování klientů v nasazení Azure DevOps Serveru, který využívá protokol HTTPS, protokol SSL (Secure Sockets Layer) a certifikáty.

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

Možnost	Popis
počítač	Určuje, že seznam certifikátů bude z kontextu místního počítače namísto aktuálního kontextu uživatele.
vypnout	Určuje, že nastavení klientského ověřovacího certifikátu bude zakázané.
automatický výběr	Určuje, že certifikát bude automaticky vybrán ze seznamu certifikátů. Okno Spravovat klientské certifikáty se neotevře.
noprompt	Určuje, že okno Spravovat klientské certifikáty se při spuštění příkazu Certifikáty neotevře.
otisky palců	Určuje, že se použije certifikát, který odpovídá zadanému kryptografickému otisku. Více než jeden certifikát můžete zadat tak, že jednotlivé kryptografické otisky oddělíte čárkou.

Požadavky

Pokud chcete použít příkaz certifikáty , musíte být členem skupiny zabezpečení Azure DevOps Administrators a místní skupiny Administrators na počítači, ze kterého příkaz spustíte. Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Ve výchozím nastavení příkaz certifikáty automaticky vybere klientský certifikát ze seznamu certifikátů pro aktuálního uživatele. Můžete však použít možnosti pro příkaz k zadání konkrétního certifikátu nebo certifikátů z aktuálního kontextu uživatele nebo z kontextu místního počítače.

Než použijete příkaz certifikáty , musíte nejprve nakonfigurovat servery v nasazení Azure DevOps Serveru tak, aby využívaly certifikáty. Další informace najdete v tématu Nastavení HTTPS s protokolem SSL (Secure Sockets Layer) pro Azure DevOps Server.

Pomocí příkazu certifikáty nakonfigurujete klientské certifikáty používané nasazením Azure DevOps Serveru, který je nakonfigurovaný tak, aby používal protokol HTTPS/SSL a certifikáty. Pokud použijete příkaz Certifikáty bez možností, klientský certifikát se automaticky vybere z aktuálního kontextu uživatele, ze kterého příkaz spustíte.

Příklady

Následující příklad ukazuje, jak zadat certifikát místního počítače, který má kryptografický otisk aa bb cc dd ee bez výzvy.

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

Následující příklad ukazuje, jak určit pomocí automatického výběru klientského certifikátu z aktuálního úložiště uživatelů.

TfsConfig certificates /autoselect

ChangeServerID

Příkaz changeServerID změní identifikátory GUID přidružené k databázím pro Azure DevOps Server. Identifikátory GUID musí být jedinečné v rámci nasazení Azure DevOps Serveru. Pokud má více než jedna databáze stejný identifikátor GUID, může být vaše nasazení nestabilní nebo nepoužitelné. Můžete změnit identifikátor GUID pro konfigurační databázi, identifikátory GUID pro všechny databáze kolekce projektů v nasazení, nebo obojí.

I když tento příkaz obvykle nepoužíváte v každodenních operacích, můžete tento příkaz použít za následujících okolností:

Obnovili jste nasazení na nový hardware, staré nasazení je stále funkční a chcete využít obě nasazení. Tento scénář se někdy označuje jako klonování serveru.
Chcete otestovat aktualizaci softwaru nebo konfiguraci hardwaru na duplicitním nasazení tak, abyste neriskovali narušení produkčního prostředí.
Chcete plně otestovat obnovení databází na nový hardware v testovacím prostředí nebo v samostatném prostředí, abyste zajistili obnovení nasazení.
Po přesunutí do jiného nasazení, pro které je tento identifikátor GUID již rezervovaný, musíte identifikátor GUID pro databázi kolekce resetovat.

Poznámka:

Příkaz changeServerID není nevratný. Po změně identifikátoru GUID nelze tuto změnu vrátit zpět s výjimkou obnovení předchozí verze této databáze.

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

Možnost	Popis
sqlInstance	Povinné. Určuje název serveru, na kterém běží SQL Server, a název instance, pokud chcete použít jinou instanci než výchozí instanci. Pokud zadáte instanci, musíte použít formát: `ServerName\InstanceName`.
název databáze	Povinné. Určuje název konfigurační databáze pro Azure DevOps Server. Ve výchozím nastavení je název této databáze TFS_ConfigurationDB.
projectCollectionsOnly	Určuje, že se změní pouze identifikátory GUID pro kolekce.
configDBOnly	Určuje, že se změní pouze identifikátor GUID konfigurační databáze.
název kolekce	Určuje, že se má vytvořit nové ID instance pro konkrétní kolekci, ale ne pro instanci Azure DevOps a další kolekce.

Požadavky

Pokud chcete použít příkaz changeServerID , musíte být členem skupiny zabezpečení Azure DevOps Administrators a členem role zabezpečení správce systému pro všechny instance SQL Serveru, které Azure DevOps Server používá. Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps.

Poznámky

Pomocí příkazu changeServerID vytvoříte diskrétní duplikát nasazení Azure DevOps Serveru pro účely testování nebo klonování. Po použití příkazu changeServerID musíte klientům před použitím směrovat připojení ke změněný server.

Příklad

Následující příklad ukazuje, jak změnit identifikátory GUID všech databází v nasazení Azure DevOps Serveru Contoso1, kde je konfigurační databáze hostovaná na serveru, který je pojmenovaný ContosoMain na pojmenované instanci TeamDatabases v SQL Serveru.

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

Kódový index

Pomocí příkazu codeIndex můžete spravovat indexování kódu na Azure DevOps Serveru. Můžete například chtít resetovat index, abyste opravili informace o CodeLensu, nebo vypněte indexování a prošetřte problémy s výkonem serveru.

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

Možnost	Popis
stav indexace	Zobrazí stav a konfiguraci služby indexování kódu.
nastavit indexování	on: Spusťte indexování všech sad změn. vypnuto: Zastavte indexování všech sad změn. keepupOnly: Zastavte indexování dříve vytvořených sad změn a začněte indexovat pouze nové sady změn.
seznam ignorovaných	Určuje seznam souborů kódu a jejich cest, které nechcete indexovat. add: Přidejte soubor, který nechcete indexovat do seznamu ignorovaných souborů. remove: Odeberte soubor, který chcete indexovat ze seznamu ignorovaných souborů. removeAll: Vymažte ignorovaný seznam souborů a začněte indexovat všechny soubory. zobrazení: Podívejte se na všechny soubory, které se neindexují. Cesta k serveru: Určuje cestu k souboru kódu. Na začátku, na konci nebo na obou koncích cesty k serveru můžete použít zástupný znak (*).
listLargeFiles	Zobrazuje zadaný počet souborů, které překračují zadanou velikost v kB. Pomocí možnosti /ignoreList pak můžete tyto soubory vyloučit z indexování. K tomu budete potřebovat Team Foundation Server 2013 s aktualizací Update 3.
reindexAll	Vymažte dříve indexovaná data a restartujte indexování.
destroyCodeIndex	Odstraňte index kódu a odeberte všechna indexovaná data. Nevyžaduje potvrzení, pokud použijete možnost /noPrompt .
dočasný limit velikosti dat	Určuje, kolik dočasných dat CodeLens vytvoří při zpracování sad změn. Výchozí limit je 6 GB (2 GB v aktualizaci Update 5). zobrazení: Zobrazit aktuální velikostní limit. SizeInGBs: Změňte limit velikosti. zakázat: Zrušit limit velikosti. Tento limit se kontroluje před tím, než CodeLens zpracuje novou sadu změn. Pokud dočasná data překročí tento limit, CodeLens pozastaví zpracování minulých sad změn, nikoli nové. CodeLens obnoví zpracování poté, co budou data vyčištěna a klesnou pod tento limit. Vyčištění se spustí automaticky jednou denně. To znamená, že dočasná data můžou tento limit překročit, dokud se nespustí vyčištění. K tomu budete potřebovat Team Foundation Server 2013 s aktualizací Update 4.
indexHistorickéObdobí	Určuje, jak dlouho se má historie změn indexovat. To má vliv na to, kolik historie CodeLens vám ukáže. Výchozí limit je 12 měsíců. To znamená, že CodeLens zobrazuje historii změn jenom za posledních 12 měsíců. zobrazit: Ukázat aktuální počet měsíců. all: Indexovat celou historii změn. NumberOfMonths: Změňte počet měsíců použitých k indexování historie změn. K tomu budete potřebovat Team Foundation Server 2013 s aktualizací Update 4.
název kolekce	Určuje název kolekce projektů, na které se má spustit příkaz CodeIndex . Vyžaduje se, pokud nepoužíváte /CollectionId.
identifikátor sbírky	Určuje identifikační číslo kolekce projektu, na které se má spustit příkaz CodeIndex . Vyžaduje se, pokud nepoužíváte /CollectionName.

Požadavky

Pokud chcete použít příkaz codeIndex , musíte být členem skupiny zabezpečení Azure DevOps Administrators. Viz referenční informace o oprávněních pro Azure DevOps Server.

Příklady

Pokud chcete zobrazit stav a konfiguraci indexování kódu:

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

Pokud chcete začít indexovat všechny sady změn:

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

Chcete-li zastavit indexování dříve vytvořených sad změn a spustit indexování pouze nových sad změn:

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

Vyhledání až 50 souborů, které jsou větší než 10 kB:

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

Pokud chcete vyloučit konkrétní soubor z indexování a přidat ho do seznamu ignorovaných souborů:

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

Pokud chcete zobrazit všechny soubory, které nejsou indexované:

TfsConfig codeIndex /ignoreList:view

Vymazání dříve indexovaných dat a restartování indexování:

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

Uložení všech historie sad změn:

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

Odebrání limitu velikosti dočasných dat CodeLens a pokračování v indexování bez ohledu na dočasnou velikost dat:

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

Odstranění indexu kódu s potvrzením:

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

Sbírka

Pomocí příkazu kolekce můžete připojit, odpojit nebo odstranit kolekci projektů z nasazení Azure DevOps Serveru. Pomocí příkazu kolekce můžete také duplikovat databázi existující kolekce, přejmenovat ji a připojit ji k nasazení. Tento proces se někdy označuje jako klonování kolekce.

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

Možnost	Popis
připojit	Vyžaduje se, pokud se nepoužívá /detach ani /delete . Pokud tuto možnost zadáte, musíte také použít možnost /collectionDB . Jako možnost můžete také použít /collectionName a /clone s touto možností. Pokud použijete možnost /attach , zadaná databáze kolekce se přidá do vašeho nasazení Azure DevOps Serveru.
vytvořit	Vytvoří kolekci.
odpojit	Vyžaduje se, pokud se nepoužívá /attach ani /delete . Pokud tuto možnost zadáte, musíte také použít možnost /collectionName . Pokud použijete možnost /detach , databáze pro zadanou kolekci se zastaví a kolekce se odpojee od nasazení Azure DevOps Serveru.
odstranit	Vyžaduje se, pokud se nepoužívá /detach ani /attach . Pokud tuto možnost zadáte, musíte také použít možnost /collectionName . Pokud použijete možnost /delete , databáze pro zadanou kolekci se zastaví a kolekce se trvale odpojuje od Azure DevOps Serveru. Databázi kolekce nebudete moct znovu připojit k tomuto ani žádnému jinému nasazení.
Název kolekce	Určuje název kolekce projektů. Pokud název kolekce obsahuje mezery, musíte ho uzavřít do uvozovek (například "Moje kolekce"). Vyžaduje se, pokud se použije /detach nebo /delete . Pokud použijete tuto možnost s parametrem /detach nebo /delete, určuje kolekci, která bude odpojena nebo odstraněna. Pokud použijete tuto možnost s parametrem /attach, určuje nový název kolekce. Pokud použijete tuto možnost s parametrem /attach i /clone, určuje název duplikované kolekce.
CollectionDB	Vyžaduje se, pokud se použije /attach . Tato možnost určuje název serveru, na kterém běží SQL Server, a název databáze kolekce hostované na tomto serveru.
Název serveru	Určuje název serveru, který je hostitelem konfigurační databáze pro Azure DevOps Server, a název instance, pokud chcete použít jinou instanci než výchozí instanci. Pokud zadáte instanci, musíte použít formát: `ServerName\InstanceName`.
Název databáze	Určuje název konfigurační databáze. Ve výchozím nastavení je název této databáze TFS_ConfigurationDB.
klon	Pokud tuto možnost zadáte, připojí se původní databáze kolekce jako klon na SQL Serveru a tato databáze se připojí k Azure DevOps Serveru. Tato možnost se primárně používá jako součást rozdělení kolekce projektů.

Návod

Možnost /delete neodstraní databázi kolekce z SQL Serveru. Po odstranění databáze kolekce z Azure DevOps Serveru můžete databázi odstranit ručně z SQL Serveru.

Požadavky

Pokud chcete použít příkaz kolekce , musíte být členem skupiny zabezpečení Team Foundation Administrators a také místní skupina Administrators na počítači se spuštěnou sadou TfsConfig. Musíte být také členem role zabezpečení správce systému pro všechny instance SQL Serveru používané databázemi Azure DevOps Serveru. Pokud je vaše nasazení integrované se službou SharePoint a používáte možnost /delete , musíte být také členem skupiny Správci farmy pro farmu služby SharePoint, ze které kolekci webů odstraňujete.

Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Ke správě kolekcí interaktivně nebo k vytvoření kolekce můžete použít uzel Kolekce projektů v konzole pro správu pro Azure DevOps. Viz Správa kolekcí projektů.

Příklady

Následující příklad ukazuje, jak trvale odebrat Contoso Summer Intern Projects kolekci projektů z nasazení Azure DevOps Serveru.

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.

Následující příklad ukazuje, jak duplikovat Contoso Summer Interns Projects kolekci projektů, pojmenovat ji Contoso Winter Interns Projectsa připojit duplicitní kolekci k nasazení Azure DevOps Serveru.

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

Index úložiště sloupců

Poznámka:

Dostupnost příkazu: Vyžaduje TFS 2015.2 a novější verze.

Pomocí příkazu columnStoreIndex povolíte nebo zakážete indexy úložiště sloupců pro databáze používané nasazením Azure DevOps Serveru.

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

Možnost	Popis
povoleno	Určuje, jestli pro danou instanci a databázi SQL povolíte nebo zakážete index úložiště sloupců.
sqlInstance	Určuje název serveru, který je hostitelem databáze, pro kterou je index úložiště sloupců povolený nebo zakázaný, a název instance, pokud se používá jiná instance než výchozí. Pokud zadáte instanci, musíte použít formát: `ServerName\InstanceName`.
název databáze	Určuje název databáze, pro kterou je index úložiště sloupců povolený nebo zakázaný.

Požadavky

Chcete-li použít columnStoreIndex příkaz, musíte být členem role správce systému pro zadanou instanci SYSTÉMU SQL Server.

Poznámky

Obvykle byste použili příkaz columnStoreIndex , pokud byste přesunuli databázi z instance SQL, která podporovala index úložiště sloupců do indexu, který ne. V takovém případě byste museli zakázat všechny indexy úložiště sloupců, abyste mohli databáze úspěšně přesunout. Podobně pokud jste přesunuli databázi zpět do instance SQL, která podporovala index úložiště sloupců, můžete chtít znovu povolit index úložiště sloupců, abyste ušetřili místo a získali výkon.

Příklad

Následující příklad ukazuje, jak povolit index úložiště sloupců pro databázi pojmenovanou TFS_DefaultCollection na instanci SQL spuštěnou na serveru pojmenované ContosoMain v pojmenované instanci TeamDatabases.

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

Konfigurace pošty

Nakonfigurujte server, na kterém běží Azure DevOps Server, aby pro e-mailové výstrahy používal existující server SMTP.

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

Možnost	Popis
Emailová adresa odesílatele	Určuje adresu, ze které se mají odesílat e-mailová oznámení z Azure DevOps Serveru pro vrácení se změnami, pracovní položka přiřazená vám nebo jiná oznámení. Tato adresa je také zkontrolována na platnost a v závislosti na konfiguraci serveru může být nutné reprezentovat platný e-mailový účet na poštovním serveru. Pokud adresa neexistuje nebo není platná, použije se výchozí e-mailová adresa.
SmtpHost	Určuje název serveru, který je hostitelem poštovního serveru.

Možnost

Popis

Emailová adresa odesílatele

Určuje adresu, ze které se mají odesílat e-mailová oznámení z Azure DevOps Serveru pro vrácení se změnami, pracovní položka přiřazená vám nebo jiná oznámení. Tato adresa je také zkontrolována na platnost a v závislosti na konfiguraci serveru může být nutné reprezentovat platný e-mailový účet na poštovním serveru. Pokud adresa neexistuje nebo není platná, použije se výchozí e-mailová adresa.

SmtpHost

Určuje název serveru, který je hostitelem poštovního serveru.

Požadavky

Pokud chcete použít příkaz configureMail , musíte být členem skupiny zabezpečení Team Foundation Administrators na serveru aplikační vrstvy Azure DevOps. Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Ke konfiguraci Serveru Azure DevOps pro použití serveru SMTP můžete použít také konzolu pro správu .

Příklad

Následující příklad ukazuje syntaxi použitou ke konfiguraci z e-mailové adresy a TFS@contoso.com poštovního serveru SMTP jako ContosoMailServer:

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

Komprese databáze

Pomocí příkazu dbCompression povolíte nebo zakážete kompresi databázových stránek pro databáze používané nasazením Azure DevOps Serveru.

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

Možnost	Popis
komprese stránky	Určuje, jestli povolíte nebo zakážete kompresi stránky pro danou instanci a databázi SQL.
sqlInstance	Určuje název serveru, který je hostitelem databáze, pro kterou je povolená nebo zakázaná komprese stránky, a název instance, pokud se používá jiná instance než výchozí. Pokud zadáte instanci, musíte použít formát: `ServerName\InstanceName`
název databáze	Určuje název databáze, pro kterou je povolená nebo zakázaná komprese stránky.
rebuildNow	Volitelný. Určuje, zda mají být indexy databáze znovu sestaveny (a komprimovány nebo dekomprimovány podle potřeby) okamžitě. Pokud nejsou používány, indexy se znovu sestaví prostřednictvím úlohy na pozadí, která se spouští každý týden.
offline	Volitelný. Používá se pouze v kombinaci s /rebuildNow. Pokud není zadaný parametr /offline , indexy se znovu sestaví online. Pokud je zadaný parametr /offline , indexy se znovu sestaví offline. Tím se zablokují další operace, ale může to být rychlejší než opětovné sestavení online indexu.

Požadavky

Chcete-li použít příkaz dbCompression , musíte být členem role správce systému pro zadanou instanci SYSTÉMU SQL Server.

Poznámky

Obvykle byste použili příkaz dbCompression , pokud byste přesunuli databázi z instance SQL, která podporovala kompresi do instance, která ne. V takovém případě byste museli zakázat kompresi a dekomprimovat všechny indexy, abyste mohli úspěšně přesunout databáze. Podobně pokud jste přesunuli databázi zpět do instance SQL, která podporovala kompresi, můžete chtít kompresi znovu povolit, aby se ušetřilo místo.

Tento příkaz změní jenom to, jestli Azure DevOps Server preferuje použití komprese databázových stránek, nebo ne – vaše databáze musí být pořád hostované v instanci SQL, jejíž edice podporuje kompresi. Další informace najdete v tématu Funkce podporované edicemi SQL Serveru .

Příklad

Následující příklad ukazuje, jak okamžitě povolit kompresi stránky s indexy znovu sestaveny online pro databázi pojmenovanou TFS_DefaultCollection na instanci SQL spuštěnou na serveru pojmenovaném ContosoMain na pojmenované instanci TeamDatabases.

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

Smazat výsledky testů

Příkaz deleteTestResults slouží k odstranění starých uložených výsledků testu z úložiště kolekcí. Obvykle se to provádí, aby se zmenšila velikost úložiště nebo zkrátila doba potřebná při migraci výsledků testu do nového schématu.

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

Možnost	Popis
věkVeDnech	Výsledky testů starší než zadaný počet dní budou odstraněny nebo zobrazeny.
sqlInstance	Název serveru, který je hostitelem databáze, pro kterou se výsledky testů odstraňují nebo zobrazují v náhledu, a název instance, pokud se používá jiná instance než výchozí. Pokud zadáte instanci, musíte použít formát: `ServerName\InstanceName`.
název databáze	Název databáze, pro kterou se výsledky testů odstraňují nebo zobrazují v náhledu.
typ	Volitelný. Typ výsledků testu, který chcete odstranit. Platné hodnoty jsou automatizované, ruční a všechny.
Preview	Volitelný. Zobrazí počet výsledků testů, které by byly odstraněny na základě věku ve dnech, ale tyto výsledky neodstraňují.

Požadavky

Chcete-li použít příkaz deleteTestResults , musíte být členem role správce systému pro zadanou instanci SYSTÉMU SQL Server.

Poznámky

Pomocí parametru /preview zobrazte výsledky testů seřazené podle názvu projektu a roku bez odstranění těchto výsledků.

Příklad

Následující příklad ukazuje, jak odstranit výsledky ručního testu starší než 60 dnů pro databázi pojmenovanou TFS_DefaultCollection v instanci SQL spuštěné na serveru pojmenovaném ContosoMain na pojmenované instanci TeamDatabases.

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

Fond nasazení

Příkaz deploymentPool je navržený tak, aby pomohl migrovat všechny skupiny nasazení z jednoho fondu nasazení do jiného.

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

Možnost	Popis
fromPool	Název zdrojového fondu
toPool	Název cílového fondu

Identity

Příkazy identit vypíše nebo změní identifikátor zabezpečení (SID) uživatelů a skupin ve vašem nasazení Azure DevOps Serveru. Možná budete muset změnit nebo aktualizovat identifikátor SID pro uživatele a skupiny v jednom z následujících scénářů:

Změna domény nasazení
Změna z pracovní skupiny na doménu nebo z domény na pracovní skupinu
Migrace účtů mezi doménami ve službě Active Directory

Poznámka:

Pokud měníte domény ve stejné doménové struktuře služby Active Directory, nemusíte tento příkaz spouštět. Azure DevOps Server automaticky zpracuje změny identifikátoru SID pro přesuny ve stejné doménové struktuře.

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

Možnost	Popis
změnit	Určuje, že chcete změnit identity místo jejich výpisu.
fromdomain	Vyžaduje se při použití /change. Určuje původní doménu identit, které chcete změnit. Pokud měníte prostředí z pracovní skupiny, určete název počítače.
todomain	Vyžaduje se při použití /change. Určuje doménu, na kterou chcete změnit identity. Pokud přecházíte na prostředí pracovní skupiny, určuje název počítače.
účet	Určuje název účtu, pro který chcete zobrazit nebo změnit identity.
na účet	Určuje název účtu, na který chcete změnit identity.
SQL instance	Určuje název serveru, na kterém běží SQL Server, a název instance, pokud chcete použít jinou instanci než výchozí instanci. Pokud zadáte instanci, musíte použít následující formát: ServerName\InstanceName
Název databáze	Určuje název konfigurační databáze pro Azure DevOps Server.

Požadavky

Pokud chcete použít příkaz identit , musíte být členem skupiny zabezpečení Team Foundation Administrators a členem role správce systému pro všechny instance SYSTÉMU SQL Server, které Team Foundation Server používá. Další informace najdete v tématu Nastavení oprávnění správce proAzure DevOps Serveru .

Poznámky

Volitelně můžete určit databázi, ve které chcete změnit identity, než nakonfigurujete server aplikační vrstvy pro nasazení. Například můžete specifikovat databázi, abyste změnili účet služby při klonování nasazení serveru Azure DevOps.

Když změníte identity, cílový účet nebo účty už musí existovat ve Windows.

Před aktualizací vlastností účtů, které pomocí tohoto příkazu změníte, musíte počkat na další synchronizaci identit s Windows. Tento požadavek zahrnuje změny ze skupiny na uživatele, uživatele na skupinu a účet domény na místní účet.

Příklady

Následující příklad ukazuje, jak vypsat názvy všech uživatelů a skupin Windows, které jsou uložené na Azure DevOps Serveru, a zobrazit, jestli identifikátor SID pro každého uživatele nebo skupinu odpovídá identifikátoru SID ve Windows. Správci domény Contoso1 vytvořili doménové skupiny, jako například Contoso1\\Developers a Contoso1\\Testers, které pomáhají usnadnit správu oprávnění napříč Azure DevOps Serverem, službou SQL Server Reporting Services a produkty 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.

Následující příklad ukazuje, jak změnit identifikátory SID pro všechny účty v Azure DevOps Serveru z domény Contoso1 na identifikátory SID pro účty, které mají odpovídající názvy v ContosoPrime doméně. Pouze názvy účtů, které se shodují, budou mít aktualizovány své SID. Pokud například hholt účet existuje jako Contoso1\hholt a ContosoPrime\hholt, identifikátor SID účtu se změní na identifikátor SID pro ContosoPrime\hholt. ContosoPrime\hholt Pokud účet neexistuje, identifikátor SID se neaktualizuje pro Contoso1\hholt.

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

Následující příklad ukazuje, jak změnit účet pro jeden uživatelský účet , Contoso1\hholtna účet pro jiný uživatelský účet, ContosoPrime\jpeoples.

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

Následující příklad ukazuje, jak změnit identifikátor SID NT AUTHORITY\NETWORK SERVICE účtu služby, který se používá při nasazení Azure DevOps Serveru při změně domény nasazení z Contoso1 na ContosoPrime. Pokud chcete změnit systémový účet, jako je síťová služba, musíte postupovat podle dvoufázového procesu. Nejprve změníte účet služby z NT AUTHORITY\NETWORK SERVICE na účet domény v nové doméně TempSVC, a poté změníte účet zpět na SÍŤOVOU SLUŽBU na serveru v nové doméně. Konfigurační databáze je hostovaná na serveru, který je pojmenovaný ContosoMain na pojmenované instanci TeamDatabases v SQL Serveru.

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"

Pracovní místa

Příkaz úlohy můžete použít k vytvoření souboru protokolu, který obsahuje podrobnosti o poslední aktivitě úlohy pro konkrétní kolekci projektů nebo k opakování úlohy pro jednu nebo všechny kolekce projektů.

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

Možnost	Popis
zkusit ještě jednou	Vyžaduje se, pokud se nepoužívá /dumplog . Určuje, že poslední úloha bude znovu spuštěna pro zadanou kolekci projektů. Pokud použijete tuto možnost, musíte také použít parametr /CollectionName nebo /CollectionID .
dumplog	Vyžaduje se, pokud se nepoužívá /retry . Určuje, že nejnovější aktivita úlohy pro tuto kolekci bude odeslána do souboru protokolu. Pokud použijete tuto možnost, musíte také použít možnost /CollectionName nebo /CollectionID .
Název kolekce	Vyžaduje se, pokud se nepoužívá /CollectionID . Určuje název kolekce, pro nějž bude nejnovější úloha buď opakována (/opakovat) nebo zaprotokolována (/dumplog). Pokud chcete zadat všechny kolekce, můžete použít hvězdičku (*).
ID kolekce	Vyžaduje se, pokud se nepoužívá /CollectionName . Určuje identifikační číslo kolekce, pro kterou se nejnovější úloha buď znovu spustí (/retry), nebo se zaprotokoluje (/dumplog).

Požadavky

Pokud chcete použít příkaz úlohy , musíte být členem skupiny zabezpečení Azure DevOps Administrators. Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Pokud chcete úlohu opakovat interaktivně, můžete otevřít konzolu pro správu Pro Azure DevOps, vybrat kartu Stav pro kolekci a pak vybrat Úlohu opakování. Další informace najdete v tématu Otevření konzoly pro správu Azure DevOps.

Příklad

Následující příklad ukazuje, jak vytvořit soubor protokolu, který uvádí nejnovější aktivitu úlohy pro Contoso Summer Intern Projects kolekci projektů na serveru Azure DevOps.

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

OfflineDetach

Pomocí příkazu offlineDetach změníte offline databázi kolekce na odpojenou offline databázi kolekce.

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

Možnost	Popis
configurationDB	Určuje název konfigurační databáze, která se má použít.
kolekceDB	Určuje název databáze kolekce, která se má odpojit.

Požadavky

Použití příkazu offlineDetach :

Musíte být členem role správce systému pro zadanou instanci SYSTÉMU SQL Server.
Verze nástroje TFSConfig musí odpovídat verzi databáze Azure DevOps Serveru.

Poznámky

Tento příkaz upraví schéma zadané databáze kolekce a nikdy by se neměl spouštět proti databázím, které jsou aktuálně používány nasazením serveru Azure DevOps. Pokud se vaše databáze používají nasazením Azure DevOps Serveru, použijte TfsConfig collection /detach místo toho.

Tento příkaz je užitečný, když potřebujete obnovit jednotlivou databázi kolekce ze zálohy, aniž byste museli obnovovat jiné databáze kolekce, které jsou součástí stejného nasazení Azure DevOps Serveru. Dříve to vyžadovalo obnovení kompletní a konzistentní sady databází (konfigurace a všech kolekcí) do přípravného prostředí, konfiguraci nasazení Azure DevOps Serveru pomocí těchto databází a odpojení jedné kolekce zájmu.

Místo toho můžete obnovit konzistentní kopie konfigurační databáze a databáze kolekce, které vás zajímají, a spustit příkaz offlineDetach . Odpojená databáze kolekce je pak možné připojit k libovolnému nasazení Azure DevOps Serveru v příslušné verzi.

Příklad

Následující příklad znázorňuje odpojení databáze kolekce s názvem TFS_PrimaryCollection, pomocí konfigurační databáze pojmenované TFS_Configuration, s oběma instancemi SQL spuštěnými na serveru pojmenovaném ContosoTemp v pojmenované instanci Backups.

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

Zprostředkovatel

Pomocí příkazu proxy serveru můžete aktualizovat nebo změnit nastavení, které používá proxy server Azure DevOps. Proxy server Azure DevOps poskytuje podporu distribuovaným týmům, které používají správu verzí tím, že spravuje mezipaměť stažených souborů správy verzí v umístění distribuovaného týmu. Konfigurací proxy serveru Azure DevOps můžete výrazně snížit potřebnou šířku pásma napříč připojeními v široké oblasti. Kromě toho nemusíte spravovat stahování a ukládání souborů verzí do mezipaměti; správa souborů je transparentní pro vývojáře, který soubory používá. Mezitím se všechny výměny metadat a nahrávání souborů budou dál zobrazovat na Azure DevOps Serveru. Pokud k hostování vývojového projektu v cloudu používáte Azure DevOps Services, můžete použít příkaz Proxy ke správě mezipaměti pro projekty v hostované kolekci, ale také ke správě některých nastavení používaných danou službou.

Další informace o instalaci proxy serveru Azure DevOps a počáteční konfiguraci proxy serveru

Viz Postupy: Instalace proxy serveru Azure DevOps a nastavení vzdálené lokality. Další informace o konfiguraci proxy serveru na klientských počítačích najdete v referenčních informacích k příkazům správy verzí Azure DevOps.

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

Možnost	Popis
přidat	Přidá zadaný server nebo kolekci do seznamu proxy serveru v souboru Proxy.config. Pokud chcete zahrnout více kolekcí nebo serverů, můžete spustit /add vícekrát. Při použití /add s kolekcí hostovanou v Azure DevOps Services se zobrazí výzva k zadání přihlašovacích údajů ve službě Azure DevOps Services.
změnit	Změní přihlašovací údaje uložené jako účet služby pro Azure DevOps Services. Možnost /change se používá pouze pro Azure DevOps Services; Neměl by se používat pro místní nasazení Azure DevOps Serveru.
odstranit	Odebere zadaný server nebo kolekci ze seznamu proxy serveru v souboru Proxy.config.
účet	Určuje účet použitý jako účet služby pro proxy server v Azure DevOps Services. Tato možnost se používá pouze pro Azure DevOps Services ve spojení s možností /change. Výchozí účet služby používaný pro Azure DevOps Services je "Account Service".
pokračovat	Pokračuje v provádění příkazu i v případě, že proces ověření vygeneruje upozornění.
Sbírka	Určuje adresu URL kolekce projektů hostované ve `AccountName.DomainName/CollectionName` formátu Azure DevOps Services.
účet	Určuje název účtu, který se používá jako účet služby pro Azure DevOps Services. Pokud název účtu obsahuje mezery, musí být název uzavřený do uvozovek (""). Všechny speciální znaky v názvech účtů musí být zadány v souladu se syntaxí příkazového řádku.
účet	Určuje adresu URL nasazení Azure DevOps Serveru ve `ServerURL:Port/tfs` formátu.
Soubor osobního přístupového tokenu	Volitelně určuje cestu k souboru, který obsahuje osobní přístupový token. Tento token se použije k ověření pro přístup ke kolekci nebo účtu při registraci proxy serveru. (Přidáno v TFS 2018 Update 1)
vstupy	Volitelný. Určuje další nastavení a hodnoty, které se mají použít při konfiguraci proxy serveru.! Například hodnoty pro `GvfsProjectName` a `GvfsRepositoryName` lze je použít ke konfiguraci úložiště Git pro použití se systémem GVFS (Git Virtual File System ) (přidáno v TFS 2018 Update 1).

Požadavky

Pokud chcete použít příkaz proxy , musíte být členem skupiny zabezpečení Azure DevOps Administrators a správcem na proxy serveru. Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Pomocí příkazu proxy server aktualizujete stávající konfiguraci proxy serveru Azure DevOps. K počáteční instalaci a konfiguraci proxy serveru nelze použít příkaz proxy .

Příklady

Následující příklad ukazuje, jak přidat nasazení Azure DevOps Serveru s názvem FABRIKAM do seznamu proxy serverů.

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

Následující příklad ukazuje, jak přidat kolekci projektů hostovanou v Azure DevOps Services do seznamu proxy pomocí tokenu PAT k ověření. Tento token se použije jenom k registraci proxy serveru v účtu Azure DevOps Services – výchozí účet služby se bude dál používat ke spuštění proxy serveru. Tento parametr byl přidán v TFS 2018 Update 1 pro podporu registrace proxy serveru ve službě Azure DevOps Services bez nutnosti přihlášení.

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

Následující příklad ukazuje, jak přidat kolekci projektů do seznamu proxy. Tento příklad používá osobní přístupový token k ověření v kolekci zadané pomocí parametru /Collection . Osobní přístupový token, který se má použít, se uloží do souboru na adrese c:\PersonalAccessToken.txt.

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

Následující příklad ukazuje, jak změnit účet služby používaný proxy serverem pro kolekci projektů hostované v Azure DevOps Services. Kolekce má název PhoneSaver, název účtu používaný pro Azure DevOps Services je HelenaPetersen.fabrikam.coma účet služby používaný proxy serverem se mění na My Proxy Service Account. Protože název účtu obsahuje mezery, uvozovky slouží k uzavření názvu.

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

Následující příklad ukazuje, jak přidat úložiště Git pro použití s GVFS.

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

RebuildWarehouse

Příkaz rebuildWarehouse můžete použít k opětovnému sestavení databází služby SQL Server Reporting Services a SQL Server Analysis Services, které používá Azure DevOps Server.

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

Možnost	Popis
analysisServices	Vyžaduje se, pokud se nepoužívá /all . Určuje, že bude znovu sestavena pouze databáze služby Analysis Services. Pokud pro Analysis Services neexistuje žádná databáze, musíte také použít možnost /reportingDataSourcePassword .
všichni	Vyžaduje se, pokud se nepoužívá /analysisServices . Určuje, že všechny databáze pro vytváření sestav a analýzy, které Azure DevOps Server používá, se znovu sestaví.
reportingDataSourcePassword	Vyžaduje se, pokud databáze TFS_Analysis neexistuje. Určuje heslo účtu, který se používá jako účet zdrojů dat pro službu SQL Server Reporting Services (TFSReports). Další informace najdete v tématu Účty služeb a závislosti na Azure DevOps Serveru.

Požadavky

Pokud chcete použít příkaz rebuildWarehouse , musíte být členem následujících skupin:

Skupina zabezpečení Azure DevOps Administrators a skupina zabezpečení Administrators na serveru nebo serverech, na kterých běží konzola pro správu Pro Azure DevOps
Skupina sysadmin na serveru nebo serverech, na kterých běží instance SQL Serveru, která je hostitelem databází pro Azure DevOps Server

Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Tento příkaz můžete použít při přesunu nebo rozdělení kolekce projektů, obnovení dat nebo jiné změně konfigurace nasazení.

Pokud chcete znovu sestavit tyto databáze interaktivně, můžete použít uzel generování sestav v konzole pro správu pro Azure DevOps. Další informace najdete v tématu Otevření konzoly pro správu Azure DevOps.

Příklad

Následující příklad ukazuje, jak znovu sestavit databázi Analysis Services pro nasazení Azure DevOps Serveru.

TfsConfig rebuildWarehouse /analysisServices

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

RegisterDB

Použijte registerDB k aktualizaci názvu serveru, který je hostitelem konfigurační databáze v Azure DevOps Serveru. Tento příkaz můžete použít při obnovování konfigurační databáze na nový hardware nebo při změně domény nasazení.

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

Možnost	Popis
SQL instance	Povinné. Určuje název serveru, na kterém běží SQL Server, a název instance, pokud chcete použít jinou instanci než výchozí instanci. Pokud zadáte instanci, musíte použít formát: `ServerName\InstanceName`.
název databáze	Povinné. Určuje název konfigurační databáze. Ve výchozím nastavení je to Tfs_Configuration.

Požadavky

Pokud chcete použít příkaz registerDB , musíte být členem skupiny Azure DevOps Administrators na serveru aplikační vrstvy pro Azure DevOps a členem skupiny sysadmin v SQL Serveru na serveru datové vrstvy pro Azure DevOps. Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Před použitím tohoto příkazu zálohujte databáze pro Azure DevOps Server.

Aby příkaz registerDB proběhl úspěšně, musí být spuštěny následující fondy aplikací a programy:

Fond aplikací serveru Azure DevOps (fond aplikací)
ReportServer (fond aplikací)
SQL Server Reporting Services (program)

Aby tento příkaz fungoval správně, musíte zadat přesný název nebo adresu konfigurační databáze. Pokud musíte změnit server, na kterém je tato databáze uložená, musíte zajistit, aby Azure DevOps Server odkazuje na nové umístění.

Příklad

Následující příklad přesměruje Azure DevOps Server na konfigurační databázi, která se nachází na serveru ContosoMain v instanci TeamDatabasesSQL Serveru .

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

Přemapování databází

Příkaz RemapDBs přesměruje Azure DevOps Server do svých databází, když jsou uložené na více než jednom serveru a obnovujete, přesouváte nebo jinak měníte konfiguraci nasazení. Pokud jsou například hostované na samostatném serveru nebo serverech z konfigurační databáze, musíte Azure DevOps Server přesměrovat na všechny databáze pro kolekce projektů. Pokud jsou tyto databáze hostované na samostatném serveru nebo instanci z konfigurační databáze, musíte také přesměrovat Azure DevOps Server na server nebo servery se spuštěnou službou SQL Server Analysis Services nebo SQL Server Reporting Services.

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

Možnost	Popis
Název databáze	Určuje název serveru, který je hostitelem databáze, kterou chcete mapovat pro Azure DevOps Server, kromě názvu samotné databáze.
Instance SQL	Určuje název serveru, na kterém běží SQL Server, kromě názvu instance, pokud chcete použít jinou instanci než výchozí instanci. Pokud zadáváte více než jeden server, je nutné použít čárku k oddělení více dvojic názvů serverů a instancí.
Instance AnalysisInstance	Volitelný. Určuje název serveru a instance, která je hostitelem služby SQL Server Analysis Services. Tuto možnost použijte k určení serveru a instance, která je hostitelem databáze služby Analysis Services.
AnalysisDatabaseName	Volitelný. Určuje název databáze služby Analysis Services, kterou chcete použít s Azure DevOps Serverem, pokud máte na serveru, který jste zadali pomocí možnosti /AnalysisInstance , více než jednu takovou databázi.
Preview	Volitelný. Zobrazí akce, které musíte provést k aktualizaci konfigurace.
pokračovat	Volitelný. Určuje, že příkaz RemapDB by měl pokračovat, i když dojde k chybě během pokusu o vyhledání jedné nebo více databází. Pokud použijete možnost /continue , všechny kolekce, jejichž databáze nejsou nalezeny na serveru nebo serverech, které zadáte, budou překonfigurovány tak, aby používaly server a instanci, která je hostitelem konfigurační databáze.

Požadavky

Pokud chcete použít příkaz RemapDBs , musíte být členem skupiny zabezpečení Azure DevOps Administrators a členem skupiny zabezpečení správce systému pro všechny databáze SQL Serveru, které Azure DevOps Server používá. Další informace najdete v referenčních informacích k oprávněním pro Azure DevOps Server.

Poznámky

Pomocí příkazu RemapDBs překonfigurujete Azure DevOps Server tak, aby používal různé servery a instance SQL Serveru ze serverů a instancí v původní instalaci.

Příklad

Následující příklad ukazuje, jak přesměrovat Azure DevOps Server do konfigurační databáze TFS_Configuration. Tato databáze je hostována ContosoMain v pojmenované instanci TeamDatabases. Databáze kolekce projektů jsou uloženy jak na ContosoMain\TeamDatabases, tak i na výchozí instanci na Contoso2.

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

Fronta úkolů pro opravu

Pomocí příkazu repairJobQueue opravíte naplánované úlohy, které se zastavily pro hostitele nasazení a kolekce.

TfsConfig repairJobQueue

Požadavky

Pokud chcete použít příkaz repairJobQueue , musíte být členem místní skupiny administrators na počítači se spuštěnou sadou TfsConfig. Musíte být také členem role zabezpečení správce systému pro všechny instance SQL Serveru používané nasazením Azure DevOps Serveru.

Poznámky

Příkaz repairJobQueue byste obvykle použili, pokud si všimnete, že některé naplánované úlohy nejsou spuštěné.
Příkaz nepřebírá žádné argumenty a vyžaduje, aby bylo nasazení Azure DevOps Serveru konfigurováno.

Příklad

TfsConfig repairJobQueue

Nastavení

Pomocí příkazu nastavení můžete automatizovat změny lokátoru jednotného prostředku (URL), který používá rozhraní oznámení, a také automatizovat adresu serveru pro Azure DevOps Server. Ve výchozím nastavení se adresa URL rozhraní oznámení a adresa URL serveru shodují v Azure DevOps Serveru, ale můžete nakonfigurovat samostatné adresy URL. Můžete například chtít použít jinou adresu URL pro automatické e-maily, které Azure DevOps Server generuje. Pokud chcete aktualizovat všechny servery tak, aby používaly nové adresy URL, musíte tento nástroj spustit z aplikační vrstvy.

Pokud chcete tyto adresy URL změnit interaktivně nebo jenom zobrazit aktuální nastavení, můžete použít konzolu pro správu Pro Azure DevOps. Podívejte se na stručnou příručku k administrativní úloze.

TfsConfig settings [/publicURL:URL]

Možnost	Popis
veřejná URL	Určuje adresu URL serveru aplikační vrstvy pro Azure DevOps. Tato hodnota je uložená v konfigurační databázi pro Azure DevOps.

Požadavky

Musíte být členem ve skupině zabezpečení Azure DevOps Administrators a skupiny Administrators na aplikačním serveru. Další informace najdete v tématu Nastavení oprávnění správce proAzure DevOps Serveru .

Poznámky

Příkaz nastavení změní informace o připojení pro komunikaci mezi servery v nasazení Azure DevOps Serveru. Adresa URL zadaná v /publicURL musí být dostupná pro všechny servery v rámci nasazení.

Příklad

Následující příklad změní hodnotu NotificationURL na http://contoso.example.com/tfs a hodnotu ServerURL na http://contoso.example.com:8080/tfs.

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

Nastavení

Pomocí instalačního příkazu odinstalujte funkce, které jsou aktuálně nakonfigurované na počítači, na kterém příkaz spouštíte.

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

Možnost

popis

/odinstalovat

Určuje jednu nebo více funkcí, které se mají odinstalovat z počítače, na kterém příkaz spustíte. Mezi možnosti patří: All, ApplicationTier, Search a VersionControlProxy.

Požadavky

Pokud chcete použít instalační příkaz , musíte být členem skupiny zabezpečení Azure DevOps Administrators.

Příklady

Následující příklad odinstaluje všechny funkce Azure DevOps Serveru z aktuálního počítače.

TfsConfig setup /uninstall:All

Následující příklad odinstaluje aplikační vrstvu a funkce sestavení z aktuálního počítače.

TfsConfig setup /uninstall:ApplicationTier

TCM

Při upgradu na nejnovější verzi Azure DevOps Serveru se systém automaticky pokusí upgradovat komponenty správy testů, včetně testovacích plánů a sad.

Pokud automatická migrace selže, pomocí příkazu TCM upgradujte testovací plány a sady testů ručně na příslušné typy pracovních položek (WIT).

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

Možnost

popis

/upgradeTestPlans

Vyžaduje se, pokud se nepoužívá /upgradeStatus .

Převede existující testovací plán a testovací sady tak, aby ukazovaly na testovací plány založené na pracovních položkách a testovací sady. Aktualizuje také existující data správy testů a propojení mezi jinými existujícími artefakty testů, jako jsou testovací body, testovací běhy a výsledky testů.

/upgradeStatus

Vyžaduje se, pokud se nepoužívá /upgradeTestPlans .

Hlásí stav migrace testovacích dat pro zadaný projekt. Bude také indikovat, jestli má zadaný projekt nějaké testovací plány.

/NázevKolekce:NázevKolekce

Povinné. Určuje kolekci projektů, která obsahuje projekt, pro který chcete migrovat testovací data, nebo zkontrolujte stav migrace.

Pokud jsou v názvu kolekce projektů mezery, uzavřete ho do uvozovek, například "Fabrikam Fiber Collection".

/TeamProjectName:TeamProjectName

Povinné. Určuje projekt, pro který chcete migrovat testovací data, nebo zkontrolujte stav migrace. Tento projekt musí být definován v kolekci, kterou jste zadali pomocí parametru /collectionName .

Pokud jsou v názvu projektu mezery, uzavřete ho do uvozovek, například "Můj projekt".

Požadavky

Musíte být členem skupiny zabezpečení Team Foundation Administrators a správcem na serveru aplikační vrstvy.

Viz Nastavení oprávnění správce pro Azure DevOps Server.

Poznámky

Abyste mohli tento příkaz použít, musíte upgradovat server aplikační vrstvy na nejnovější verzi Azure DevOps Serveru 2019.

Než budete moci použít příkaz TCM, musíte nejprve importovat definici pracovní položky testovacího plánu a kategorii testovacího plánu do projektu.

Další informace o migraci a o tom, kdy použít tento příkaz, najdete v tématu Ruční aktualizace pro podporu správy testů.

Příkaz TCM se použije u jednotlivých projektů. Pokud potřebujete upgradovat testovací plány ve více než jednom projektu, budete je muset spouštět pro každý projekt jednotlivě.

Příkaz TCM musíte spustit z adresáře nástrojů pro Azure DevOps Server. Ve výchozím nastavení je toto umístění: drive:\%programfiles%\TFS 12.0\Tools.

Příkaz TCM použijete pouze v případě, že automatická migrace existujících testovacích dat selže.

Další informace o migraci a o tom, kdy použít tento příkaz, najdete v ručních aktualizacích pro podporu správy testů. Pokud nemáte přístup k testovacím plánům nebo testovacím sadám definovaným před upgradem serveru, spusťte TFSConfig TCM upgradeStatus a zjistěte stav migrace.

Spustíte příkaz TCM pro jednotlivé projekty. Pokud potřebujete upgradovat více než jeden projekt, budete muset proces upgradu spustit pro každý projekt zvlášť.

Příklady

Následující příklad ukazuje, jak zkontrolovat stav upgradu testovacího plánu v projektu Fabrikam Fiber hostované ve výchozí kolekci projektů (DefaultCollection):

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

Bezobslužný režim

Dostupnost příkazů: Azure DevOps Server 2019

Příkaz bezobslužné instalace je určený pro uživatele, kteří jsou obeznámeni s Azure DevOps Serverem a procesem konfigurace a kteří potřebují nainstalovat Azure DevOps Server na různé počítače.

Pokud například používáte Azure DevOps Build, můžete použít příkaz bezobslužné instalace více buildových serverů pomocí stejného konfiguračního souboru.

K vytvoření souboru bezobslužné instalace použijte možnost /create. Tento soubor definuje všechny parametry konfigurace pro instalaci Azure DevOps Serveru. Dále použijte možnost /configure k provedení konfigurace.

Tento proces umožňuje nakonfigurovat Azure DevOps Server od začátku do konce, aniž byste museli během procesu instalace zadávat vstup. V případě více instalací to také pomáhá zajistit, aby se na více serverech používaly přesně stejné konfigurační parametry.

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

Možnost	Popis
vytvořit	Vytvoří bezobslužný soubor s názvem a parametry, které zadáte.
konfigurovat	Nakonfiguruje Azure DevOps Server pomocí souboru pro bezobslužnou instalaci a zadaných parametrů. U této možnosti je nutné použít /type nebo /unattendfile.
typ	Určuje typ konfigurace, která se má použít. Při použití parametru /configure se vyžaduje parametr /type nebo /unattendfile, ale nemůžete použít obojí.
unattendfile	Určuje soubor bezobslužné aplikace, který se má vytvořit nebo použít, v závislosti na tom, jestli je počáteční parametr /create nebo /configure. Při použití /configure je vyžadován /unattendfile nebo /type.
vstupy	Volitelný. Pokud použijete parametr /create, určuje nastavení a hodnoty, které se mají použít při vytváření souboru bezobslužné nabídky. Pokud použijete /configure, určuje se další nastavení a hodnoty, které se mají použít ve spojení se souborem bezobslužné instalace. Jako alternativu k použití /vstupů můžete ručně upravit soubor bezobslužné databáze v libovolném editoru prostého textu. To je nezbytné pro určité vstupní typy, například ServiceAccountPassword nebo PersonalAccessToken, protože tyto tajné hodnoty nelze nastavit pomocí parametru /input.
ověřit	Volitelný. Určuje provádění konfigurace, které pouze provádí ověřovací kontroly na základě souboru pro bezobslužnou instalaci, vstupů a typu konfigurace. Jedná se o alternativu k provedení úplné konfigurace.
pokračovat	Volitelný. Určuje, že /create nebo /configure by měly pokračovat bez ohledu na upozornění z ověřovacích kontrol.

Typ instalace	Popis
NewServerBasic	Nakonfiguruje základní vývojové služby pro Azure DevOps Server. To zahrnuje správu zdrojového kódu, pracovní položky, sestavení a volitelné vyhledávání.
NewServerAdvanced	Nakonfiguruje základní vývojové služby a umožňuje volitelnou konfiguraci integrace se službou Reporting Services.
Vylepšení	Upgraduje Azure DevOps Server na aktuální verzi z podporované předchozí verze.
PreProductionUpgrade	Otestujte upgrade na existujícím nasazení Azure DevOps Serveru v předprodukčním prostředí. Obvykle se to provádí pomocí databází obnovených z produkčních záloh. Tento scénář zahrnuje další kroky, které zajistí, aby nové nasazení nenarušovalo produkční nasazení.
ApplicationTierOnlyBasic	Nakonfigurujte novou aplikační vrstvu pomocí existujícího nastavení ze zadané konfigurační databáze. Tato možnost umožňuje rychle zprovoznění nové aplikační vrstvy pomocí existujících nastavení. Pokud chcete mít možnost změnit existující nastavení, použijte místo toho typ Advanced ApplicationTierOnlyAdvanced.
ApplicationTierOnlyAdvanced	Nakonfigurujte novou aplikační vrstvu s plnou kontrolou nad všemi nastaveními. Nastavení se ve výchozím nastavení nastaví na existující hodnoty ze zadané konfigurační databáze. Pokud chcete zachovat všechna existující nastavení, použijte místo toho typ ApplicationTierOnlyBasic.
Klon	Nakonfigurujte nové nasazení Azure DevOps Serveru, což je klon existujícího nasazení. To se obvykle provádí pomocí databází obnovených z produkčních záloh k vytvoření prostředí, ve kterém je možné testovat změny konfigurace, rozšíření a další úpravy. Tento scénář zahrnuje další kroky, které zajistí, aby nové nasazení nenarušovalo produkční nasazení.
Zprostředkovatel	Nakonfiguruje službu proxy správy verzí.

Požadavky

V počítači, na kterém instalujete software, musíte být členem skupiny Administrators.
V závislosti na typu instalace můžete také vyžadovat další oprávnění správce.

Pokud například k instalaci Azure DevOps Serveru používáte příkaz bezobslužné instalace, musíte být členem skupiny sysadmin v instanci SQL Serveru, která bude podporovat Azure DevOps Server. Další informace najdete v části Q &A přidání správců na úrovni serveru do Azure DevOps Serveru.

Poznámky

Než budete moct použít příkaz bezobslužné instalace ke konfiguraci Azure DevOps Serveru, musíte vytvořit účty služeb , které budete používat jako součást nasazení. Musíte také nainstalovat veškerý požadovaný software pro zvolený typ instalace. To zahrnuje samotný Azure DevOps Server. Musíte nainstalovat Azure DevOps Server, ale nemusíte ho konfigurovat, protože příkaz bezobslužné instalace to udělá za vás.

Příkaz unattend nakonfiguruje komponenty Azure DevOps Serveru. Neprovádí počáteční instalaci softwaru. Konfiguruje software podle vašich specifikací po zobrazení bitů v počítači.

Příklady

Následující příklad ukazuje, jak vytvořit soubor bezobslužné instalace pro základní instalaci Azure DevOps Serveru.

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

V tomto příkladu se bezobslužný soubor vytvoří ve stejném adresáři jako příkaz. Soubor protokolu se vytvoří jako součást příkazu a umístění souboru se vrátí v příkazu jako součást spuštění příkazu.

Následující příklad ukazuje, jak zadat úložiště Git pro použití s GVFS během konfigurace.

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

Následující příklad ukazuje, jak vytvořit soubor bezobslužné instalace pro konfiguraci proxy serveru Azure DevOps.

Důležité

V tomto příkladu, pokud správci chtějí k ověřování použít osobní přístupový token, budou muset soubor ručně upravit, aby zadali hodnotu tokenu pat. Toho lze dosáhnout přidáním řádku pro osobní přístupový token do vytvořeného souboru bezobslužného přístupu, například: PersonalAccessToken=PersonalAccessTokenValue.

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

Následující příklad ukazuje, jak vytvořit soubor bezobslužné instalace pro konfiguraci sestavení Azure DevOps Serveru na serveru pomocí FabrikamFiber\BuildSVC účtu služby sestavení a pak pomocí tohoto souboru bezobslužné instalace nakonfigurovat azure DevOps Server Build.

Důležité

V tomto příkladu správce po vytvoření souboru bezobslužné aktualizace ručně upraví soubor tak, aby zadal heslo pro účet služby sestavení. Když přidáte heslo jako vstup pomocí ServiceAccountPassword=PasswordPlaceholder; , nepřidá se do souboru informace o hesle.

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

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

První příkaz vrátí následující:

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

Druhý příkaz vrátí následující informace, včetně názvu serveru, na kterém byl nakonfigurovaný FabrikamFiberTFS azure DevOps Build, a kolekce projektů přidružená k řadiči 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

Příkaz ziplogs je navržen tak, aby shromáždil protokoly a zahodí zip na ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

Last updated on 2025-12-20

Sdílet prostřednictvím

Použití TFSConfig ke správě Azure DevOps místně

Umístění nástroje příkazového řádku

Požadavky

Výpis příkazů a získání nápovědy

Účty

Požadavky

Poznámky

Příklady

PřidatProjektovéZprávy

Požadavky

Poznámky

Příklad

Autentizace

Požadavky

Poznámky

Příklad

Certifikáty

Požadavky

Poznámky

Příklady

ChangeServerID

Požadavky

Poznámky

Příklad

Kódový index

Požadavky

Příklady

Sbírka

Požadavky

Poznámky

Příklady

Index úložiště sloupců

Požadavky

Poznámky

Příklad

Konfigurace pošty

Požadavky

Poznámky

Příklad

Komprese databáze

Požadavky

Poznámky

Příklad

Smazat výsledky testů

Požadavky

Poznámky

Příklad

Fond nasazení

Identity

Požadavky

Poznámky

Příklady

Pracovní místa

Požadavky

Poznámky

Příklad

OfflineDetach

Požadavky

Poznámky

Příklad

Zprostředkovatel

Požadavky

Poznámky

Příklady

RebuildWarehouse

Požadavky

Poznámky

Příklad

RegisterDB

Požadavky

Poznámky

Příklad

Přemapování databází

Požadavky

Poznámky

Příklad

Fronta úkolů pro opravu

Požadavky

Poznámky