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

Článek
04/03/2024

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

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.

NÁSTROJ TFSConfig lze 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 jsou nainstalované v adresáři /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ě, musí být nástroj TFSConfig schopen připojit se k různým serverům a službám, které jsou součástí 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. Požadavky na konkrétní příkazy budou uvedeny níže.

Mnoho příkazů TFSConfig se musí spustit z příkazového řádku se zvýšenými oprávněními, a to i v případě, že má spuštěný uživatel přihlašovací údaje správce. Pokud chcete otevřít příkazový řádek se zvýšenými oprávněními, klikněte na Start, klikněte pravým tlačítkem na Příkazový řádek a potom klikněte na Spustit jako správce. Další informace najdete v tématu Řízení uživatelských účtů.

Akce správy můžete také provádět interaktivně pomocí konzoly pro správu pro Azure DevOps Server. Viz Stručná referenční příručka úlohy správy.

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

Pokud chcete zobrazit úplný seznam příkazů TFSConfig , použijte příkaz help :

TFSConfig help

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

TFSConfig help accounts

Účty

Ke správě těchto účtů služby Azure DevOps Server použijte příkaz accounts.

účet služby Azure DevOps Server
účet zdrojů dat pro 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 Server.

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

Operace	Description
UpdatePassword	Změní heslo účtu, který se používá jako účet služby. Změní existující účet a všechny typy účtů, které se spouští jako daný účet.
Změnit	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, aby ho používala. Starý účet se tím neodebere z prostředků. Pokud možnost accountType nepoužijete, účet služby pro aplikační vrstvu se změní.
Přidání	Nový účet přidá jenom k potřebným prostředkům. Užitečné pro scénáře vyrovnávání zatížení sítě. Pokud jsou některé kolekce nedostupné, použijte příznak continue. Přidání můžete později spustit znovu a aktualizovat tak všechny chybějící kolekce. Přidá účet do skupin, které jsou potřeba pro použití účtu jako účtu služby.
Set	Nastaví pouze službu tak, aby používala účet, který už je k prostředkům přidaný. Užitečné pro scénáře vyrovnávání zatížení sítě.
Odstranit	Odebere účet ze všech prostředků. Při odstraňování účtu byste měli použít bezpečnostní opatření, protože to může způsobit odepření služby jiným serverům.
ResetOwner	Pokud se databáze obnoví v rámci přesunu, klonování nebo zotavení po havárii, vlastník databáze může přepnout na správce obnovující server. Tato možnost iteruje všechny databáze a nastaví přihlášení dbo na aktuálního vlastníka.

Accounttype	Description
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ítier	Změní účet služby v appPool pro základní webové služby. (TFSService)
Proxy server	Změní účet služby na appPool pro webové služby proxy. (TFSProxy)
ReportingDataSource	Změní účet, který sestavy používají pro přístup k datům sestav. (TFSReports)

Výchozí hodnota je ApplicationTier.

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

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

Poznámka

Účty musí být ve formátu název_domény\uživatelské_jméno. U systémových účtů je nutné použít uvozovky u celé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 volitelný, pokud používáte systémový účet nebo účet, který nemá heslo, například 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 než výchozí instanci. Název a instanci je nutné zadat v následujícím formátu: Název_serveru\Název_instance.
databaseName	Používá se pouze s /ResetOwner. Určuje název databáze, jejíž vlastnictví chcete změnit. Pomocí tohoto příkazu resetujete vlastnictví databáze, kterou zadáte, na účet, pod kterým příkaz spouštíte.
continue	Aktualizace 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 vyrovnávání zatížení sítě.

Požadavky

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

Skupina zabezpečení Správci Azure DevOps
role správce systému pro všechny instance SQL Server, které vaše instance Azure DevOps Server používá.

Pokud použijete možnost /proxy , musíte být správcem 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 automatizujte změny účtů služeb, databází a skupin účtů služeb Azure DevOps Server. Můžete nakonfigurovat účty, které jste už vytvořili, ale nemůžete je vytvářet.

Než změníte doménu nebo pracovní skupinu účtu, musí mít účet citlivý účet, který nemůže být delegovaný na serveru aplikační vrstvy. 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 Server. 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 Network Service 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í databáze na TFS_WarehouseContosoMain SQL Server v pojmenované TeamDatabases 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 se nastaví na účet, pod kterým spouštíte příkaz .

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

PřidatProjectReports

Poznámka

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

Pomocí příkazu addProjectReports můžete přidat nebo přepsat sestavy pro existující týmový projekt.

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

Možnost	Popis
– kolekce	Povinná hodnota. Adresa URL kolekce týmových projektů
týmový projekt	Povinná hodnota. Určuje název týmového projektu.
šablona	Povinná hodnota. Určuje název šablony procesu. Dostupné možnosti jsou Agilní, CMMI a Scrum.
Síla	Nepovinný parametr. Určuje, že sestavy by měly být přepsány, pokud již existují.

Požadavky

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

Poznámky

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

Tento příkaz může být potřeba použít v těchto případech:

Projekt se vytvořil 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 v Azure DevOps Server.

Pokud chcete přepsat sestavy v projektu výchozími sestavami, protože jste upgradovali Azure DevOps Server a staré sestavy v projektu už nejsou kompatibilní, použijte možnost /force. Pokud jste sestavy přizpůsobili, vytvořte si před tím zálohu.

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

Příklad

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

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

Authentication

Příkaz authentication změní protokol ověřování sítě, který Azure DevOps Server aplikační vrstvy nebo proxy webu používá.

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

Možnost

Popis

/viewAll

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

/provider: { NTLM | Vyjednat }

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

NTLM: Použití ověřovacího protokolu NTML
Vyjednávání: 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. Výchozí je aplikační vrstva.

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ím správcem 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 závisí. Správce spustí tento příkaz z aplikační vrstvy, aby aktualizoval weby, které vyžadují změnu protokolu síťového ověřování. Příkaz změní vlastnost NTAuthenticationProviders v metabázi služby IIS.

Než použijete ověřovací příkaz ke změně ověřovacího protokolu, můžete spuštěním příkazu s možností /viewAll zjistit, jaká jsou existující nastavení.

Příklad

Následující příklad zobrazuje aktuální hodnotu, která je přiřazena protokolu 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 Server, který využívá protokol HTTPS, ssl (Secure Sockets Layer) a certifikáty.

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

Možnost	Popis
Stroj	Určuje, že seznam certifikátů bude pocházet z kontextu místního počítače, a ne z aktuálního kontextu uživatele.
zákaz	Určuje, že nastavení certifikátu ověřování klienta bude zakázáno.
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.
žádný postup	Určuje, že se při spuštění příkazu Certifikáty neotevře okno Spravovat klientské certifikáty.
kryptografické otisky	Určuje, že se použije certifikát, který odpovídá zadanému kryptografickému otisku. Můžete zadat více než jeden certifikát oddělením jednotlivých kryptografických otisků čá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 spouští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. Pomocí možností příkazu však můžete zadat konkrétní certifikát nebo certifikáty 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 ve vašem nasazení Azure DevOps Server tak, aby využívaly certifikáty. Další informace najdete v tématu Nastavení protokolu HTTPS s protokolem SSL (Secure Sockets Layer) pro Azure DevOps Server.

Příkaz certifikáty slouží ke konfiguraci klientských certifikátů používaných nasazením Azure DevOps Server, které byly nakonfigurovány tak, aby používaly protokol HTTPS/SSL a certifikáty. Pokud použijete příkaz Certifikáty bez možností, klientský certifikát se automaticky vybere z kontextu aktuálního 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 zadat pomocí automatického výběru klientského certifikátu z úložiště aktuálního uživatele.

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 v rámci nasazení Azure DevOps Server jedinečné. Pokud má více než jedna databáze stejný identifikátor GUID, může se vaše nasazení stát nestabilním nebo nepoužitelným. Můžete změnit identifikátor GUID konfigurační databáze, identifikátory GUID pro všechny databáze kolekce projektů v nasazení nebo obojí.

I když byste tento příkaz obvykle nepoužívali v každodenních operacích, můžete ho použít v následujících případech:

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 při duplicitním nasazení, abyste neriskli 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, že bude možné obnovit vaše nasazení.
Po přesunutí do jiného nasazení, pro které je tento identifikátor GUID již rezervován, musíte resetovat identifikátor GUID databáze kolekce.

Poznámka

Příkaz changeServerID je 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á hodnota. Určuje název serveru, na kterém běží SQL Server, a název instance, pokud chcete použít jinou než výchozí instanci. Pokud zadáte instanci, musíte použít formát : `ServerName\InstanceName`.
databaseName	Povinná hodnota. 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 budou změněny 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 ostatní kolekce.

Požadavky

Pokud chcete použít příkaz changeServerID, musíte být členem skupiny zabezpečení Správci Azure DevOps a členem role zabezpečení správce systému pro všechny instance SQL Server, které Azure DevOps Server používají. 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 dedikovaný duplikát nasazení Azure DevOps Server pro účely testování nebo klonování. Po použití příkazu changeServerID musíte klientům před jeho použitím nasměrovat, aby vytvořili 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í Contoso1 Azure DevOps Server, kde je konfigurační databáze hostovaná na serveru s názvem ContosoMain na pojmenované instanci TeamDatabases v SQL Server.

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

Index kódu

Pomocí příkazu codeIndex můžete spravovat indexování kódu na Azure DevOps Server. Můžete například chtít obnovit index, abyste opravili informace CodeLens, nebo vypnout indexování a prozkoumat 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
indexováníStatus	Zobrazení stavu a konfigurace služby indexování kódu
nastaveníIndexování	on: Začněte indexovat všechny sady 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 jenom nové sady změn.
ignoreList	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 ze seznamu ignorovaných souborů soubor, který chcete indexovat. removeAll: Vymažte seznam ignorovaných souborů a začněte indexovat všechny soubory. zobrazení: Zobrazte všechny soubory, které nejsou indexovány. ServerPath: Určuje cestu k souboru kódu. Zástupný znak (*) můžete použít na začátku, na konci nebo na obou koncích cesty k serveru.
listLargeFiles	Zobrazí zadaný počet souborů, které překračují zadanou velikost v kB. Potom můžete použít možnost /ignoreList k vyloučení těchto souborů 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. Pokud použijete možnost /noPrompt , nevyžaduje potvrzení.
dočasnéDataSizeLimit	Určete, 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). view: Zobrazení aktuálního limitu velikosti. SizeInGBs: Změňte limit velikosti. disable: Odeberte 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ých. CodeLens restartuje zpracování po vyčištění dat a poklesne pod tento limit. Čištění se spouští automaticky jednou denně. To znamená, že dočasná data můžou tento limit překročit, dokud se čištění nesběží. K tomu budete potřebovat Team Foundation Server 2013 s aktualizací Update 4.
IndexHistoryPeriod	Určete, jak dlouho se má historie změn indexovat. To má vliv na to, kolik historie vám CodeLens ukáže. Výchozí limit je 12 měsíců. To znamená, že CodeLens zobrazuje pouze historii změn za posledních 12 měsíců. zobrazení: Zobrazí aktuální počet měsíců. all: Indexování historie všech změn. NumberOfMonths: Umožňuje změnit 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 projektu, na které se má spustit příkaz CodeIndex . Vyžaduje se, pokud nepoužíváte /CollectionId.
id kolekce	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í Správci Azure DevOps. Viz Referenční informace k oprávněním pro Azure DevOps Server.

Příklady

Zobrazení stavu a konfigurace indexování kódu:

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

Indexování všech sad změn spustíte tak, že:

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

Pokud chcete zastavit indexování dříve vytvořených sad změn a začít indexovat jenom nové sady změn:

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

Vyhledání až 50 souborů větších než 10 kB:

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

Vyloučení určitého souboru z indexování a jeho přidání 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í historie všech sad změn:

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

Pokud chcete odebrat limit velikosti dočasných dat CodeLens a pokračovat v indexování bez ohledu na velikost dočasných dat:

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

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

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

Kolekce

Pomocí příkazu kolekce můžete připojit, odpojit nebo odstranit kolekci projektu z nasazení Azure DevOps Server. 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 zadáte tuto možnost, musíte použít také možnost /collectionDB . Jako možnost můžete použít také /collectionName a /clone s touto možností. Pokud použijete možnost /attach, bude zadaná databáze kolekce přidána do vašeho nasazení Azure DevOps Server.
vytvoření	Vytvoří kolekci.
Odpojit	Vyžaduje se, pokud se nepoužívá /attach ani /delete . Pokud zadáte tuto možnost, musíte použít také možnost /collectionName . Pokud použijete možnost /detach, databáze pro zadanou kolekci se zastaví a kolekce bude odpojena od nasazení Azure DevOps Server.
delete	Vyžaduje se, pokud se nepoužívá /detach ani /attach . Pokud zadáte tuto možnost, musíte použít také možnost /collectionName . Pokud použijete možnost /delete, databáze pro zadanou kolekci se zastaví a kolekce bude trvale odpojena od Azure DevOps Server. K tomuto ani jinému nasazení nebudete moct znovu připojit databázi kolekce.
Název kolekce	Určuje název kolekce projektů. Pokud název kolekce obsahuje mezery, musíte název uzavřít do uvozovek (například "Moje kolekce"). Vyžaduje se, pokud se používá /detach nebo /delete . Pokud tuto možnost použijete s /detach nebo /delete, určuje kolekci, která bude odpojena nebo odstraněna. Pokud tuto možnost použijete s parametrem /attach, určí nový název kolekce. Pokud tuto možnost použijete s /attach i /clone, určuje název duplicitní 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.
ServerName	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`.
DatabaseName	Určuje název konfigurační databáze. Ve výchozím nastavení je název této databáze TFS_ConfigurationDB.
clone	Pokud zadáte tuto možnost, původní databáze kolekce bude připojena jako klon v SQL Server a tato databáze bude připojena k Azure DevOps Server. Tato možnost se primárně používá jako součást rozdělení kolekce projektů.

Tip

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

Požadavky

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

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

Poznámky

K interaktivní správě kolekcí 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 kolekci Contoso Summer Intern Projects projektů z nasazení 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.

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

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

ColumnStoreIndex

Poznámka

Dostupnost příkazů: 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 Server.

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

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

Požadavky

Pokud chcete použít příkaz columnStoreIndex, musíte být členem role správce systému pro zadanou instanci SQL Server.

Poznámky

Obvykle byste použili příkaz columnStoreIndex , pokud jste přesunuli databázi z instance SQL, která podporovala index úložiště sloupců, do databáze, která ne. V takovém případě byste museli před úspěšným přesunem databází zakázat všechny indexy úložiště sloupců. Podobně pokud jste přesunuli databázi zpět do instance SQL, která podporovala index úložiště sloupců, možná budete chtít index úložiště sloupců znovu povolit, 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 s názvem TFS_DefaultCollection na instanci SQL spuštěné na serveru s názvem ContosoMain na pojmenované instanci TeamDatabases.

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

Konfigurovat poštu

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

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

Možnost	Popis
FromEmailAddress	Určuje adresu, ze které se mají odesílat e-mailová oznámení od Azure DevOps Server o ohlášení, pracovní položce, která vám byla přiřazena, nebo jiná oznámení. Tato adresa se také kontroluje z důvodu platnosti a v závislosti na konfiguraci vašeho serveru může představovat 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

FromEmailAddress

Určuje adresu, ze které se mají odesílat e-mailová oznámení od Azure DevOps Server o ohlášení, pracovní položce, která vám byla přiřazena, nebo jiná oznámení. Tato adresa se také kontroluje z důvodu platnosti a v závislosti na konfiguraci vašeho serveru může představovat 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 o oprávněních pro Azure DevOps Server

Poznámky

Konzolu pro správu můžete také použít ke konfiguraci Azure DevOps Server pro použití serveru SMTP.

Příklad

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

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

DBCompression

Pomocí příkazu dbCompression povolíte nebo zakážete kompresi stránky databáze pro databáze používané nasazením Azure DevOps Server.

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

Možnost	Popis
pageCompression	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 povolena nebo zakázána komprese stránky, a název instance, pokud je použita jiná než výchozí instance. Pokud zadáte instanci, musíte použít formát: `ServerName\InstanceName`
databaseName	Určuje název databáze, pro kterou je povolena nebo zakázána komprese stránky.
rebuildNow	Nepovinný parametr. Určuje, jestli mají být indexy databáze okamžitě znovu sestaveny (a podle potřeby komprimovány nebo dekomprimovány). Pokud se nepoužije, indexy budou znovu sestaveny úlohou na pozadí, která se spouští každý týden.
Offline	Nepovinný parametr. Používá se pouze v kombinaci s /rebuildNow. Pokud / offline není zadaný, indexy budou znovu sestaveny online. Pokud je zadaný parametr /offline , indexy budou znovu sestaveny offline. Tím se zablokují další operace, ale může 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 SQL Server.

Poznámky

Obvykle byste použili příkaz dbCompression , pokud jste přesunuli databázi z instance SQL, která podporovala kompresi, do databáze, 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, abyste ušetřili místo.

Tento příkaz pouze změní, jestli Azure DevOps Server preferuje použití komprese stránky databáze nebo ne – 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 Server.

Příklad

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

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

OdstranitTestResults

Příkaz deleteTestResults slouží k odstranění starých uložených výsledků testů z úložiště kolekcí. Obvykle se to provádí za účelem zmenšení velikosti úložiště nebo zkrácení doby potřebné při migraci výsledků testů do nového schématu.

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

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

Požadavky

Pokud chcete použít příkaz deleteTestResults, musíte být členem role správce systému pro zadanou instanci SQL Server.

Poznámky

Pomocí parametru /preview zobrazte výsledky testu 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 s názvem TFS_DefaultCollection v instanci SQL spuštěné na serveru s názvem ContosoMain na pojmenované instanci TeamDatabases.

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

Fond nasazení

Příkaz deploymentPool slouží k migraci všech skupin 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říkaz identit vypíše nebo změní identifikátor zabezpečení (SID) uživatelů a skupin ve vašem nasazení Azure DevOps Server. Možná budete muset změnit nebo aktualizovat IDENTIFIKÁTOR SID pro uživatele a skupiny v některém z následujících scénářů:

Změna domény vašeho 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 SID pro přesuny v rámci stejné doménové struktury.

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	Povinné při použití /change. Určuje původní doménu identit, které chcete změnit. Pokud měníte prostředí pracovní skupiny, určuje název počítače.
todomain	Povinné 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.
account	Určuje název účtu, pro který chcete vypsat nebo změnit identity.
toaccount	Určuje název účtu, na který chcete změnit identity.
SQLInstance	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
DatabaseName	Určuje název konfigurační databáze pro Azure DevOps Server.

Požadavky

Chcete-li 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 SQL Server instance, které Team Foundation Server používá. Další informace najdete v tématu Nastavení oprávnění správce pro Azure DevOps Server.

Poznámky

Před konfigurací serveru aplikační vrstvy pro nasazení můžete volitelně určit databázi, která má měnit identity. Můžete například zadat databázi, která změní účet služby při klonování nasazení Azure DevOps Server.

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

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

Příklady

Následující příklad ukazuje, jak vypsat jména všech uživatelů a skupin Systému Windows, které jsou uložené v Azure DevOps Server, a zobrazit, jestli identifikátor SID každého uživatele nebo skupiny odpovídá identifikátoru SID ve Windows. Správci domény Contoso1 vytvořili skupiny domén, jako Contoso1\\Developers jsou aContoso1\\Testers, aby usnadnili správu oprávnění v Azure DevOps Server, SQL Server Reporting Services a SharePoint Products.

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 Server z domény Contoso1 na IDENTIFIKÁTORy SID pro účty, které mají odpovídající názvy v doméněContosoPrime. Identifikátory SID se aktualizují jenom v názvech účtů, které se shodují. Pokud hholt například účet existuje jako Contoso1\hholt a ContosoPrime\hholt, identifikátor SID účtu se změní na SID pro ContosoPrime\hholt. ContosoPrime\hholt Pokud účet neexistuje, identifikátor SID nebude aktualizován 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 Server 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 provést dvoufázový proces. Nejprve změníte účet služby z NT AUTHORITY\NETWORK SERVICE na účet domény v nové doméně TempSVCa pak změníte účet zpět na NETWORK SERVICE na serveru v nové doméně. Konfigurační databáze je hostovaná na serveru s názvem ContosoMain na pojmenované instanci TeamDatabases v 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"

Úlohy

Příkaz jobs můžete použít k vytvoření souboru protokolu, který poskytuje 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
retry	Povinný argument, pokud se nepoužívá /dumplog . Určuje, že nejnovější úloha bude znovu reatteptována pro zadanou kolekci projektu. Pokud použijete tuto možnost, musíte také použít možnost /CollectionName nebo /CollectionID .
dumplog	Vyžaduje se, pokud se nepoužívá /retry . Určuje, že poslední aktivita úlohy pro 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 kterou se bude opakovat poslední úloha (/retry) nebo protokolovat (/dumplog). Pokud chcete zadat všechny kolekce, můžete použít hvězdičku (*).
ID_kolekce	Povinný argument, pokud / CollectionName není použit. Určuje identifikační číslo kolekce, pro kterou se bude opakovat poslední úloha (/retry) nebo protokolovat (/dumplog).

Požadavky

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

Poznámky

Pokud chcete úlohu interaktivně opakovat, můžete otevřít konzolu pro správu pro Azure DevOps, vybrat kartu Stav kolekce a pak vybrat Opakovat úlohu. 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 kolekci Contoso Summer Intern Projects projektu v Azure DevOps Server.

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

OfflineDetach

Pomocí příkazu offlineDetach můžete z offline databáze kolekce vytvořit odpojenou offline databázi kolekcí.

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

Pokud chcete použít příkaz offlineDetach, musíte být členem role správce systému pro zadanou instanci SQL Server.

Poznámky

Tento příkaz upraví schéma zadané databáze kolekce a nikdy by neměl být spuštěn proti databázím, které jsou používány nasazením Team Foundation Serveru. Pokud jsou vaše databáze používány nasazením Team Foundation Serveru, použijte TfsConfig collection /detach místo toho.

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

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

Příklad

Následující příklad znázorňuje odpojení databáze kolekce s názvem TFS_PrimaryCollectionpomocí konfigurační databáze s názvem TFS_Configuration, přičemž obě jsou na instanci SQL spuštěné na serveru s názvem ContosoTemp na pojmenované instanci Backups.

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

Proxy server

Pomocí příkazu proxy můžete aktualizovat nebo změnit nastavení používaná proxy serverem Azure DevOps. Proxy server Azure DevOps poskytuje distribuovaným týmům podporu používání správy 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říč širokými připojeními. Kromě toho nemusíte spravovat stahování a ukládání souborů verzí do mezipaměti; správa souborů je pro vývojáře, který soubory používá, transparentní. Mezitím se všechny výměny metadat a nahrávání souborů budou dál zobrazovat v Azure DevOps Server. Pokud používáte Azure DevOps Services k hostování vývojového projektu v cloudu, můžete příkaz Proxy použít nejen 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 najdete tady:

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

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

Možnost	Popis
add	Přidá zadaný server nebo kolekci do seznamu proxy v souboru Proxy.config. Příkaz /add můžete spustit několikrát a zahrnout tak více kolekcí nebo serverů. Při použití příkazu /add s kolekcí hostovanou na Azure DevOps Services se zobrazí výzva k zadání přihlašovacích údajů v 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ěla by se používat pro místní nasazení Azure DevOps Server.
delete	Odebere zadaný server nebo kolekci ze seznamu proxy v souboru Proxy.config.
account	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 Služba účtu.
continue	Pokračuje v provádění příkazu, i když ověřovací proces vyvolá upozornění.
Kolekce	Určuje adresu URL kolekce projektů hostované na Azure DevOps Services ve `AccountName.DomainName/CollectionName` formátu.
account	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.
account	Určuje adresu URL Azure DevOps Server nasazení ve `ServerURL:Port/tfs` formátu.
Soubor PersonalAccessTokenFile	Volitelně určuje cestu k souboru, který obsahuje token PAT. Tento token se použije k ověření pro kolekci nebo účet při registraci proxy serveru. (Přidáno v TFS 2018 Update 1)
Vstupy	Nepovinný parametr. Určuje další nastavení a hodnoty, které se mají použít při konfiguraci proxy serveru.! Například hodnoty a `GvfsProjectNameGvfsRepositoryName` lze 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í Správci Azure DevOps a správcem 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 aktualizujete existující konfiguraci Azure DevOps Server Proxy. Příkaz proxy nelze použít pro počáteční instalaci a konfiguraci proxy serveru.

Příklady

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

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

Následující příklad ukazuje, jak přidat kolekci projektů hostované na Azure DevOps Services do seznamu proxy pomocí osobního přístupového tokenu k ověření. Tento token se použije jenom k registraci proxy serveru v účtu Azure DevOps Services – ke spuštění proxy serveru se bude dál používat výchozí účet služby. Tento parametr byl přidán do TFS 2018 Update 1 pro podporu registrace proxy serveru s Azure DevOps Services bez nutnosti výzvy k 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á token PAT k ověření vůči kolekci zadané pomocí parametru /Collection . Token PAT, 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é na Azure DevOps Services. Kolekce má název PhoneSaver, název účtu použitý 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, použijí se k uzavření názvu uvozovky.

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

Pomocí příkazu rebuildWarehouse můžete znovu sestavit SQL Server Reporting Services a Služba Analysis Services serveru SQL databáze, které Azure DevOps Server používá.

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 pro službu Analysis Services. Pokud pro službu Analysis Services neexistuje žádná databáze, musíte také použít možnost /reportingDataSourcePassword .
Vše	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žívají, budou znovu sestaveny.
reportingDataSourcePassword	Vyžaduje se, pokud TFS_Analysis databáze neexistuje. Určuje heslo účtu, který se používá jako účet zdrojů dat pro SQL Server Reporting Services (TFSReports). Další informace najdete v tématu Účty služeb a závislosti v Azure DevOps Server.

Požadavky

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

Skupina zabezpečení Správci Azure DevOps a Skupina zabezpečení Administrators na serveru nebo serverech, na kterých běží konzola pro správu azure DevOps
Skupina sysadmin na serveru nebo serverech, na kterých běží instance SQL Server hostujících databáze 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řesouvání nebo rozdělování kolekce projektů, obnovování dat nebo jiné změně konfigurace nasazení.

Pokud chcete zahájit opětovné sestavení těchto databází interaktivně, můžete použít uzel Generování sestav v konzole pro správu 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 služby Analysis Services pro nasazení 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.

RegisterDB

Pomocí registerDB aktualizujte název serveru, který je hostitelem konfigurační databáze v Azure DevOps Server. 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
Instance SQL	Povinná hodnota. Určuje název serveru, na kterém běží SQL Server, a název instance, pokud chcete použít jinou než výchozí instanci. Pokud zadáte instanci, musíte použít formát : `ServerName\InstanceName`.
databaseName	Povinná hodnota. 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 Server 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ěné následující fondy aplikací a programy:

fond aplikací Azure DevOps Server (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 odkazy na nové umístění.

Příklad

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

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í, pokud jsou uložené na více serverech a obnovujete, přesouváte nebo jinak měníte konfiguraci nasazení. Je například nutné přesměrovat Azure DevOps Server na všechny databáze pro kolekce projektů, pokud jsou hostovány na samostatném serveru nebo serverech z konfigurační databáze. Je také nutné přesměrovat Azure DevOps Server na server nebo servery se systémem Služba Analysis Services serveru SQL nebo SQL Server Reporting Services, pokud jsou tyto databáze hostované na samostatném serveru nebo instanci z konfigurační databáze.

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

Možnost	Popis
DatabaseName	Určuje název serveru, který je hostitelem databáze, kterou chcete mapovat na Azure DevOps Server, a také název samotné databáze.
Instance SQL	Určuje název serveru, na kterém běží SQL Server, a také název instance, pokud chcete použít jinou než výchozí instanci. Pokud zadáváte více než jeden server, je nutné k oddělení více dvojic názvů serverů a instancí použít čárku.
AnalysisInstance	Nepovinný parametr. Určuje název serveru a instance, které hostuje Služba Analysis Services serveru SQL. Tuto možnost použijte k určení serveru a instance, která je hostitelem databáze služby Analysis Services.
AnalysisDatabaseName	Nepovinný parametr. Určuje název databáze služby Analysis Services, kterou chcete použít s Azure DevOps Server pokud máte na serveru více než jednu takovou databázi, kterou jste zadali pomocí možnosti /AnalysisInstance.
preview	Nepovinný parametr. Zobrazí akce, které je nutné provést k aktualizaci konfigurace.
continue	Nepovinný parametr. Určuje, že má příkaz RemapDB pokračovat i v případě, že při pokusu o vyhledání jedné nebo více databází dojde k chybě. 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é hostují konfigurační databázi.

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í sysadmin pro všechny databáze SQL Server, které Azure DevOps Server používají. 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řekonfigurujte Azure DevOps Server tak, aby používaly různé servery a instance SQL Server ze serverů a instancí v původní instalaci.

Příklad

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

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

RepairJobQueue

Pomocí příkazu repairJobQueue opravíte naplánované úlohy, které přestaly běžet 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, na kterém běží TfsConfig. Musíte být také členem role zabezpečení správce systému pro všechny instance SQL Server používané nasazením Azure DevOps Server.

Poznámky

Obvykle byste použili příkaz repairJobQueue , pokud zjistíte, že nejsou spuštěné žádné naplánované úlohy.
Příkaz nepřebírají žádné argumenty a vyžaduje konfiguraci nasazení Azure DevOps Server.

Příklad

TfsConfig repairJobQueue

Nastavení

Pomocí příkazu nastavení můžete automatizovat změny adresy URL (Uniform Resource Locator), kterou používá rozhraní pro oznámení, a adresy serveru pro Azure DevOps Server. Ve výchozím nastavení se adresa URL rozhraní oznámení a adresa URL serveru shodují v Azure DevOps Server, 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 generují. 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 interaktivně změnit nebo jenom zobrazit aktuální nastavení, můžete použít konzolu pro správu pro Azure DevOps. Viz Stručná referenční příručka úlohy správy.

TfsConfig settings [/publicURL:URL]

Možnost	Popis
adresa publicUrl	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 skupiny zabezpečení Azure DevOps Administrators a skupiny Administrators na serveru aplikační vrstvy. Další informace najdete v tématu Nastavení oprávnění správce pro Azure DevOps Server.

Poznámky

Příkaz nastavení změní informace o připojení pro komunikaci mezi servery v nasazení Azure DevOps Server. 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í příkazu instalace můžete odinstalovat 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 spouštíte příkaz. Mezi možnosti patří: All, ApplicationTier, Search a VersionControlProxy.

Požadavky

Pokud chcete použít příkaz pro nastavení , musíte být členem skupiny zabezpečení Správci Azure DevOps.

Příklady

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

TfsConfig setup /uninstall:All

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

TfsConfig setup /uninstall:ApplicationTier

TCM

Při upgradu na nejnovější verzi Azure DevOps Server se systém automaticky pokusí upgradovat komponenty služby Test Management, včetně testovacích plánů a sad.

Pokud se automatická migrace nezdaří, 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 a sady testů založené na pracovních položkách. Aktualizuje také stávající data správy testů a propojení mezi další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. Zobrazí se také informace o tom, jestli má zadaný projekt nějaké testovací plány.

/CollectionName:Název_kolekce

Povinná hodnota. Určuje kolekci projektů obsahující projekt, pro který chcete migrovat testovací data nebo zkontrolovat stav migrace.

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

/TeamProjectName:TeamProjectName

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

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

Požadavky

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

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

Poznámky

Aby bylo možné tento příkaz použít, musíte server aplikační vrstvy upgradovat na nejnovější verzi Azure DevOps Server 2019.

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

Další informace o migraci a o tom, kdy tento příkaz použít, 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 ho muset spustit pro každý projekt zvlášť.

Pokud chcete Azure DevOps Server, musíte spustit příkaz TCM z adresáře tools. 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 se nezdaří automatická migrace existujících testovacích dat.

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ů. Pokud nemáte přístup k testovacím plánům nebo sadám, které byly definovány 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 ho muset spustit pro každý projekt.

Příklady

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

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

Unattend

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 Server a procesem konfigurace a potřebují nainstalovat Azure DevOps Server na různé počítače.

Pokud například používáte Azure DevOps Build, můžete pomocí příkazu bezobslužné instalace nainstalovat několik serverů sestavení pomocí stejného konfiguračního souboru.

Pomocí možnosti /create vytvořte soubor bezobslužné akce. Tento soubor definuje všechny parametry konfigurace pro instalaci Azure DevOps Server. Dále použijte možnost /configure , abyste konfiguraci skutečně provedli.

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

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

Možnost	Popis
vytvoření	Vytvoří soubor bezobslužné služby se zadaným názvem a parametry.
konfigurace	Konfiguruje Azure DevOps Server pomocí souboru bezobslužné akce a parametrů, které zadáte. S touto možností musíte použít /type nebo /unattendfile.
typ	Určuje typ konfigurace, která se má použít. Při použití parametru /configure se vyžaduje /type nebo /unattendfile, ale nemůžete použít obojí.
unattendfile	Určuje soubor bezobslužné služby, 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í příkazu /configure se vyžaduje /unattendfile nebo /type.
Vstupy	Nepovinný parametr. Pokud použijete /create, určuje nastavení a hodnoty, které se použijí při vytváření souboru bezobslužné služby. Pokud použijete parametr /configure, určuje další nastavení a hodnoty, které se použijí ve spojení se souborem bezobslužné služby. Jako alternativu k použití /inputs můžete soubor bezobslužné akce upravit ručně v libovolném editoru prostého textu. To je nezbytné pro určité typy vstupů, například ServiceAccountPassword nebo PersonalAccessToken, protože tyto tajné hodnoty nelze nastavit pomocí parametru /inputs.
verify	Nepovinný parametr. Určuje spuštění konfigurace, které dokončí ověřovací kontroly pouze na základě souboru bezobslužné služby, vstupů a typu konfigurace. Jedná se o alternativu k provedení úplné konfigurace.
continue	Nepovinný parametr. Určuje, že /create nebo /configure mají pokračovat bez ohledu na upozornění z ověřovacích kontrol.

Typ instalace	Description
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ě Search.
NovýServerAdvanced	Konfiguruje základní vývojové služby a umožňuje volitelnou konfiguraci integrace se službou Reporting Services.
Upgrade	Upgrady Azure DevOps Server na aktuální verzi z podporované předchozí verze.
PředproductionUpgrade	Otestujte upgrade na existujícím nasazení Azure DevOps Server v předprodukčním prostředí. Obvykle se k tomu používají databáze obnovené z produkčních záloh. Tento scénář zahrnuje další kroky, které zajistí, že nové nasazení nebude narušovat produkční nasazení.
ApplicationTierOnlyBasic	Nakonfigurujte novou aplikační vrstvu pomocí existujících 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 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. Výchozí nastavení nastavení bude mít existující hodnoty ze zadané konfigurační databáze. Pokud chcete zachovat všechna existující nastavení, použijte místo toho typ ApplicationTierOnlyBasic.
Clone	Nakonfigurujte nové nasazení Azure DevOps Server, které je klonem 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í, že nové nasazení nebude narušovat produkční nasazení.
Proxy server	Nakonfiguruje službu proxy správy verzí.

Požadavky

Na počítači, do kterého software instalujete, 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 Server používáte příkaz unattend , musíte být členem skupiny sysadmin v instanci SQL Server, která bude podporovat Azure DevOps Server. Další informace najdete v části Q & A tématu Přidání správců na úrovni serveru do Azure DevOps Server.

Poznámky

Než použijete příkaz bezobslužné instalace ke konfiguraci Azure DevOps Server, musíte vytvořit účty služeb, které budete používat jako součást nasazení. Musíte také nainstalovat požadovaný software pro zvolený typ instalace. To zahrnuje Azure DevOps Server samotné. 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 bezobslužné konfigurace Azure DevOps Server komponent. Neprovádí počáteční instalaci softwaru. Nakonfiguruje software podle vašich specifikací po přítomnosti 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 Server.

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

V tomto příkladu se soubor bezobslužné instalace 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é

Pokud v tomto příkladu chtějí správci k ověřování použít token PAT, budou muset soubor ručně upravit a zadat hodnotu osobního přístupového tokenu. Toho lze dosáhnout přidáním řádku pro token PAT do vytvořeného souboru bezobslužné registrace, 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 Azure DevOps Server Sestavení na serveru pomocí FabrikamFiber\BuildSVC účtu služby sestavení a pak nakonfigurovat Azure DevOps Server Sestavení pomocí tohoto souboru bezobslužné instalace.

Důležité

V tomto příkladu správce po vytvoření souboru bezobslužnéobí ručně upraví soubor a určí heslo pro účet služby sestavení. Když přidáte heslo jako vstup pomocí příkazu ServiceAccountPassword=Password; , 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 je nakonfigurovaná FabrikamFiberTFS služba Azure DevOps Build, a kolekce projektů přidružené k kontroleru 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

Protokoly zip

Příkaz ziplogs je navržený tak, aby shromažďuje protokoly a zahodí zip na adrese ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

Sdílet prostřednictvím

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

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řidatProjectReports

Požadavky

Poznámky

Příklad

Authentication

Požadavky

Poznámky

Příklad

Certifikáty

Požadavky

Poznámky

Příklady

ChangeServerID

Požadavky

Poznámky

Příklad

Index kódu

Požadavky

Příklady

Kolekce

Požadavky

Poznámky

Příklady

ColumnStoreIndex

Požadavky

Poznámky

Příklad

Konfigurovat poštu

Požadavky

Poznámky

Příklad

DBCompression

Požadavky

Poznámky

Příklad

OdstranitTestResults

Požadavky

Poznámky

Příklad

Fond nasazení

Identity

Požadavky

Poznámky

Příklady

Úlohy

Požadavky

Poznámky

Příklad

OfflineDetach

Požadavky

Poznámky

Příklad

Proxy server

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

RepairJobQueue

Požadavky

Poznámky