Usar o TFSConfig para gerenciar o Azure DevOps local

Artigo
04/03/2024

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

Você pode usar a ferramenta de linha de comando TFSConfig para executar uma variedade de ações administrativas para sua implantação local do Azure DevOps.

O TFSConfig pode ser executado em qualquer computador no qual Azure DevOps Server foi instalado.

Local da ferramenta de linha de comando

As ferramentas de linha de comando do Azure DevOps são instaladas no diretório /Tools de um servidor da camada de aplicativo do 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

Pré-requisitos

Para que muitos comandos operem corretamente, o TFSConfig precisará ser capaz de se conectar aos vários servidores e serviços que fazem parte da implantação do TFS, e o usuário que executa o TFSConfig precisará ter permissões administrativas para esses mesmos servidores e serviços. Os requisitos para comandos específicos serão chamados abaixo.

Muitos comandos TFSConfig devem ser executados em um Prompt de Comando com privilégios elevados, mesmo que o usuário em execução tenha credenciais administrativas. Para abrir um Prompt de Comando com privilégios elevados, clique em Iniciar, clique com o botão direito do mouse em Prompt de Comando e clique em Executar como Administrador. Para obter mais informações, consulte: Controle de Conta de Usuário.

Você também pode executar ações administrativas interativamente usando o console de administração para Azure DevOps Server. Consulte Referência rápida da tarefa administrativa.

Listar comandos e obter ajuda

Para exibir uma lista completa de comandos TFSConfig , use o comando de ajuda :

TFSConfig help

Para obter ajuda para um comando individual, use o comando de ajuda e especifique o nome do comando com o qual você deseja ajuda. Por exemplo, para obter ajuda para o comando contas :

TFSConfig help accounts

Contas

Use o comando contas para gerenciar essas contas de serviço Azure DevOps Server.

a conta de serviço Azure DevOps Server
a conta de fontes de dados para SQL Server Reporting Services
a conta de serviço do Servidor Proxy do Azure DevOps

Você também pode usar esse comando para alterar a propriedade dos bancos de dados 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]

Operação	Descrição
UpdatePassword	Altera a senha de uma conta usada como uma conta de serviço. Altera a conta existente e todos os accountTypes executados como a conta fornecida.
Alterar	Altera a conta usada como a conta de serviço. Adiciona a nova conta aos recursos e grupos necessários, concede as permissões necessárias e define o serviço para usá-la. Isso não remove a conta antiga dos recursos. Se você não usar a opção accountType , a conta de serviço da camada de aplicativo será alterada.
Adicionar	Adiciona apenas a nova conta aos recursos necessários. Útil para cenários NLB. Use o sinalizador continue se algumas coleções estiverem inacessíveis. Adicionar pode ser executado novamente mais tarde para atualizar todas as coleções perdidas. Adiciona uma conta aos grupos necessários para usar a conta como uma conta de serviço.
Set	Define apenas o serviço para usar uma conta já adicionada aos recursos. Útil para cenários NLB.
Excluir	Remove a conta de todos os recursos. As precauções devem ser usadas ao excluir uma conta, pois ela pode fazer com que outros servidores sejam negados.
ResetOwner	Se os bancos de dados forem restaurados como parte de uma movimentação, clone ou recuperação de desastre, o proprietário do banco de dados poderá alternar para o administrador que restaura o servidor. Essa opção itera em todos os bancos de dados e define o logon dbo como o proprietário atual.

AccountType	Descrição
AdminConsole	Console de Administração Usuários são usuários que receberam as permissões mínimas em vários recursos para usar o console.
ApplicationTier	Altera a conta de serviço no appPool para os principais serviços Web. (TFSService)
Proxy	Altera a conta de serviço no appPool para os serviços Web proxy. (TFSProxy)
ReportingDataSource	Altera a conta que os relatórios usam para acessar os dados de relatório. (TFSReports)

O valor padrão é ApplicationTier.

O sqlInstance e databaseName só são apropriados para uso ao adicionar uma conta a bancos de dados antes que a camada de aplicativo seja configurada. Isso é útil principalmente em cenários de recuperação de desastre em que outra conta é necessária antes de executar o assistente de configuração somente AT.

A opção continue é usada ao adicionar ou alterar uma conta. Para essas operações, a conta é alterada em cada banco de dados de coleção. Se continuar for fornecido, ele continuará se uma coleção for inacessível. Ele pode ser executado novamente quando eles estiverem acessíveis.

Observação

As contas devem estar no formato domainName\userName. Para contas do sistema, você deve usar aspas em torno do nome completo da conta (por exemplo, "NT Authority\Network Service"). As contas do sistema não exigem uma senha.

Parâmetro	Descrição
Conta	Especifica o nome da conta que você deseja adicionar, alterar ou excluir de um tipo de conta referenciado, como /AccountType:ApplicationTier.
Senha	Especifica a senha da conta de serviço. Esse parâmetro será opcional se você estiver usando uma conta do sistema ou uma conta que não tenha uma senha, como o Serviço de Rede.
sqlInstance	Usado somente com /ResetOwner. Especifica o nome do servidor que está executando SQL Server e o nome da instância se você quiser usar uma instância diferente da instância padrão. Você deve especificar o nome e a instância no seguinte formato: Servername\instancename.
databaseName	Usado somente com /ResetOwner. Especifica o nome do banco de dados cuja propriedade você deseja alterar. Usando esse comando, você redefine a propriedade do banco de dados que você especifica para a conta na qual está executando o comando.
continue	Atualizações todos os grupos que não estão disponíveis quando você executa o comando. Essa opção geralmente é usada em cenários NLB.

Pré-requisitos

Para usar o comando de contas , você deve ser membro de:

o grupo de segurança Administradores do Azure DevOps
a função sysadmin para todas as instâncias SQL Server que sua instância de Azure DevOps Server usa.

Se você usar a opção /proxy , deverá ser um administrador no servidor proxy.

Para obter mais informações, consulte Referência de permissão para Azure DevOps Server.

Comentários

Use o comando contas para automatizar alterações nas contas de serviço, bancos de dados e grupos de contas de serviço de Azure DevOps Server. Você pode configurar contas que já criou, mas não pode criar contas.

Antes de alterar o domínio ou grupo de trabalho de uma conta, a conta deve ter a conta confidencial e não pode ser delegada no servidor da camada de aplicativo. Para obter mais informações, consulte esta página no site da Microsoft: Habilitando a autenticação delegada.

O comando accounts dá suporte a implantações de Azure DevOps Server locais. Para alterar o proprietário da conta de uma conta Azure DevOps Services, consulte Alterar a propriedade da conta.

Exemplos

Altere a conta de serviço de fontes de dados para Reporting Services para uma nova conta no domínio contoso, Contoso\NewAccounte a senha, para Password.

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

Adicione a conta do sistema de Serviço de Rede aos grupos de contas de serviço para Azure DevOps Server (as contas do sistema não têm senhas).

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

Altere a propriedade do banco de TFS_Warehouse dados no ContosoMain SQL Server na TeamDatabases instância nomeada para a conta de usuário na qual você está executando o comando.

Observação

Você não pode especificar qual conta definir como o proprietário dos bancos de dados ao usar esse comando. O proprietário será definido como a conta na qual você está executando o comando.

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

AddProjectReports

Observação

O comando addProjectReports está disponível com o TFS 2017.1 e versões posteriores.

Use o comando addProjectReports para adicionar ou substituir relatórios para um projeto de equipe existente.

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

Opção	Descrição
collection	Obrigatórios. URL da Coleção de Projetos de Equipe.
Teamproject	Obrigatórios. Especifica o nome do projeto de equipe.
template	Obrigatórios. Especifica o nome do modelo de processo. As opções disponíveis são Agile, CMMI e Scrum.
force	Opcional. Especifica que os relatórios devem ser substituídos se já existirem.

Pré-requisitos

Para usar o comando addProjectReports , você deve ter permissões para executar o TFSConfig e carregar relatórios no Reporting Service.

Comentários

Você usa o comando addProjectReports quando o projeto não tem relatórios ou deseja atualizar os relatórios definidos para um processo.

Talvez seja necessário usar este comando quando:

O projeto foi criado no portal do Azure DevOps e não no Visual Studio
O projeto foi criado a partir do Visual Studio, no entanto, os relatórios não foram configurados no Azure DevOps Server.

Se você quiser substituir relatórios em seu projeto por relatórios padrão porque você atualizou Azure DevOps Server e relatórios antigos em seu projeto não são mais compatíveis, use a opção /force. Se você tiver relatórios personalizados, faça um backup antes de fazer isso.

Para saber mais sobre como adicionar relatórios a uma Azure DevOps Server local, consulte Adicionar relatórios a um projeto.

Exemplo

O exemplo a seguir mostra como adicionar relatórios Agile ao MyProject projeto na http://myTfsServer:8080/tfs/DefaultCollection coleção de projetos.

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

Autenticação

O comando Autenticação altera o protocolo de autenticação de rede que o Azure DevOps Server camada de aplicativo ou site proxy usa.

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

Opção

Descrição

/viewAll

Exibe as configurações de autenticação atuais para Azure DevOps Server.

/provider: { NTLM | Negociar }

Especifica o provedor de autenticação que você deseja configurar para o site.

NTLM: usar o protocolo de autenticação NTML
Negociar: usar o protocolo de autenticação Negotiate (Kerberos)

/siteType

Especifica o site (camada de aplicativo ou proxy) cujo protocolo de autenticação de rede você deseja alterar. A camada de aplicativo é o padrão.

Pré-requisitos

Para usar o comando Autenticação , você deve ser um membro do grupo de segurança Administradores do Azure DevOps e um administrador local no servidor de camada de aplicativo ou servidor proxy, dependendo do valor da opção siteType .

Comentários

O comando Autenticação é usado por um administrador que deseja alterar o protocolo de autenticação de rede para um ou mais sites nos quais o Azure DevOps Server depende. O administrador executa esse comando na camada de aplicativo para atualizar os sites que exigem uma alteração no protocolo de autenticação de rede. O comando altera a propriedade NTAuthenticationProviders na metabase do IIS.

Antes de usar o comando Autenticação para alterar o protocolo de autenticação, você pode executar o comando com a opção /viewAll para ver quais são as configurações existentes.

Exemplo

O exemplo a seguir exibe o valor atual atribuído ao protocolo de autenticação de rede.

TFSConfig Authentication /viewAll

Certificados

Use o comando certificates para alterar a forma como os certificados são configurados para autenticação de cliente em uma implantação de Azure DevOps Server que utiliza HTTPS, SSL (secure sockets layer) e certificados.

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

Opção	Descrição
computador	Especifica que a lista de certificados será do contexto do computador local em vez do contexto atual do usuário.
disable	Especifica que a configuração do certificado de autenticação do cliente será desabilitada.
autoSelect	Especifica que um certificado será selecionado automaticamente na lista de certificados. A janela Gerenciar Certificados do Cliente não será aberta.
Noprompt	Especifica que a janela Gerenciar Certificados do Cliente não será aberta quando o comando Certificados for executado.
Impressões digitais	Especifica que o certificado que corresponde à impressão digital especificada será usado. Você pode especificar mais de um certificado separando impressões digitais individuais com uma vírgula.

Pré-requisitos

Para usar o comando certificados , você deve ser membro do grupo de segurança Administradores do Azure DevOps e do grupo administradores local no computador do qual você executa o comando. Para obter mais informações, consulte Referência de permissão para Azure DevOps Server.

Comentários

Por padrão, o comando certificados selecionará automaticamente um certificado do cliente na lista de certificados para o usuário atual. No entanto, você pode usar as opções para o comando especificar um certificado ou certificados específicos do contexto de usuário atual ou do contexto do computador local.

Antes de usar o comando certificados, você deve primeiro configurar os servidores em sua implantação de Azure DevOps Server para utilizar certificados. Para obter mais informações, consulte Configurando HTTPS com SSL (Secure Sockets Layer) para Azure DevOps Server.

Você usa o comando certificates para configurar os certificados de cliente usados por uma implantação de Azure DevOps Server que foi configurado para usar HTTPS/SSL e certificados. Se você usar o comando Certificados sem opções, um certificado do cliente será selecionado automaticamente no contexto de usuário atual do qual você executa o comando.

Exemplos

O exemplo a seguir mostra como especificar o certificado do computador local que tem a impressão digital aa bb cc dd ee sem solicitação.

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

O exemplo a seguir mostra como especificar usando a seleção automática de um certificado do cliente do repositório de usuários atual.

TfsConfig certificates /autoselect

ChangeServerID

O comando changeServerID altera os GUIDs associados aos bancos de dados para Azure DevOps Server. Os GUIDs devem ser exclusivos em uma implantação de Azure DevOps Server. Se mais de um banco de dados tiver o mesmo GUID, sua implantação poderá se tornar instável ou inutilizável. Você pode alterar o GUID do banco de dados de configuração, os GUIDs para todos os bancos de dados de coleção de projetos na implantação ou ambos.

Embora você normalmente não use esse comando em operações diárias, você pode usar esse comando nas seguintes circunstâncias:

Você restaurou sua implantação para um novo hardware, a implantação antiga ainda está operacional e você deseja utilizar ambas as implantações. Às vezes, esse cenário é chamado de clonagem do servidor.
Você deseja testar uma atualização de software ou uma configuração de hardware em uma implantação duplicada para não correr o risco de interromper seu ambiente de produção.
Você deseja testar totalmente a restauração de bancos de dados em um novo hardware em um laboratório de teste ou em um ambiente separado, para garantir que sua implantação possa ser restaurada.
Você deve redefinir o GUID de um banco de dados de coleção depois de movê-lo para outra implantação para a qual o GUID já está reservado.

Observação

O comando changeServerID não é reversível. Depois que um GUID for alterado, você não poderá desfazer essa alteração, exceto restaurando uma versão anterior desse banco de dados.

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

Opção	Descrição
sqlInstance	Obrigatórios. Especifica o nome do servidor que está executando SQL Server e o nome da instância se você quiser usar uma instância diferente da instância padrão. Se você especificar uma instância, deverá usar o formato: `ServerName\InstanceName`.
databaseName	Obrigatórios. Especifica o nome do banco de dados de configuração para Azure DevOps Server. Por padrão, o nome desse banco de dados é TFS_ConfigurationDB.
projectCollectionsOnly	Especifica que somente os GUIDs para coleções serão alterados.
configDBOnly	Especifica que somente o GUID do banco de dados de configuração será alterado.
collectionName	Especifica a criação de uma nova ID de instância para a coleção específica, mas não para a instância do Azure DevOps e as outras coleções.

Pré-requisitos

Para usar o comando changeServerID, você deve ser membro do grupo de segurança Administradores do Azure DevOps e membro da função de segurança sysadmin para todas as instâncias de SQL Server que Azure DevOps Server usa. Para obter mais informações, consulte Referência de permissão para o Azure DevOps.

Comentários

Use o comando changeServerID para criar uma duplicata discreta de uma implantação de Azure DevOps Server para fins de teste ou clonagem. Depois de usar o comando changeServerID , você deve direcionar os clientes para criar uma conexão com o servidor alterado antes que ele possa ser usado.

Exemplo

O exemplo a seguir mostra como alterar os GUIDs de todos os bancos de dados na implantação contoso1 de Azure DevOps Server, em que o banco de dados de configuração é hospedado no servidor nomeado ContosoMain na instância TeamDatabases nomeada no SQL Server.

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

CodeIndex

Use o comando codeIndex para gerenciar a indexação de código em Azure DevOps Server. Por exemplo, você pode desejar redefinir o índice para consertar informações CodeLens ou desativar a indexação para investigar problemas de desempenho do servidor.

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

Opção	Descrição
indexingStatus	Mostra o status e a configuração do serviço de indexação de código.
setIndexing	on: iniciar a indexação de todos os conjuntos de alterações. off: interromper a indexação de todos os conjuntos de alterações. keepupOnly: interromper a indexação de conjuntos de alterações criados anteriormente e iniciar apenas a indexação de novos conjuntos de alterações.
ignoreList	Especifica uma lista de arquivos de código e seus caminhos que você não deseja indexar. add: adicionar o arquivo que você não deseja indexar à lista de arquivos ignorados. remove: remover o arquivo que você deseja que seja indexado na lista de arquivos ignorados. removeAll: limpar a lista de arquivos ignorados e iniciar a indexação de todos os arquivos. view: ver todos os arquivos que não estão sendo indexados. ServerPath: especifica o caminho para um arquivo de código. É possível usar o caractere curinga (*) no início, no fim ou em ambas as extremidades do caminho do servidor.
listLargeFiles	Mostra o número especificado de arquivos que excede o tamanho especificado em KB. É possível usar a opção /ignoreList para excluir esses arquivos da indexação. Para isso, você precisará do Team Foundation Server 2013 com a Atualização 3.
reindexAll	Limpe os dados indexados anteriormente e reinicie a indexação.
destroyCodeIndex	Exclua o índice de código e remota todos os dados indexados. Não requererá confirmação se você usar a opção /noPrompt.
temporaryDataSizeLimit	Controle quantos dados temporários que o CodeLens cria ao processar conjuntos de alterações. O limite padrão é 6 GB (2 GB na Atualização 5). exibir: mostrar o limite do tamanho atual. SizeInGBs: altere o limite de tamanho. desabilitar: remover o limite do tamanho. Esse limite é verificado antes de CodeLens processa um novo conjunto de alterações. Se os dados temporários excederem esse limite, o CodeLens pausará o processamento de conjuntos de alterações passados, não novos. CodeLens reiniciará o processamento depois que os dados são limpos e ficar abaixo desse limite. Limpeza executa automaticamente uma vez por dia. Isso significa que os dados temporários podem exceder esse limite até que a limpeza começa a ser executado. Para isso, você precisará do Team Foundation Server 2013 com a Atualização 4.
indexHistoryPeriod	Controle por quanto tempo indexar o histórico de alterações. Isso afeta a quantidade de histórico que o CodeLens mostra a você. O limite padrão é 12 meses. Isso significa que o CodeLens mostra seu histórico de alterações apenas dos últimos 12 meses. exibir: mostrar o número atual de meses. tudo: indexar todo o histórico de alterações. NumberOfMonths: altere o número de meses usados para indexar o histórico de alterações. Para isso, você precisará do Team Foundation Server 2013 com a Atualização 4.
collectionName	Especifica o nome da coleção de projetos na qual executar o comando CodeIndex. Obrigatório se você não usar /CollectionId.
collectionId	Especifica o número de identificação da coleção de projetos na qual executar o comando CodeIndex. Obrigatório se você não usar /CollectionName

Pré-requisitos

Para usar o comando codeIndex , você deve ser membro do grupo de segurança Administradores do Azure DevOps. Consulte Referência de permissão para Azure DevOps Server.

Exemplos

Para ver o status e a configuração de indexação do código:

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

Para iniciar a indexação de todos os conjuntos de alterações:

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

Para interromper a indexação de conjuntos de alterações criados anteriormente e iniciar indexação apenas para novos conjuntos de alterações:

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

Para encontrar até 50 arquivos maiores que 10 KB:

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

Para excluir um arquivo específico da indexação e adicioná-lo à lista de arquivos ignorados:

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

Para ver todos os arquivos que não estão indexados:

TfsConfig codeIndex /ignoreList:view

Para limpar os dados indexados anteriormente e reinicie a indexação:

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

Para salvar todo o histórico de alterações:

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

Para remover o limite de tamanho CodeLens os dados temporários e continuar a indexação independentemente do tamanho de dados temporários:

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

Para excluir o índice de código com confirmação:

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

Coleção

Você pode usar o comando de coleção para anexar, desanexar ou excluir uma coleção de projetos de uma implantação de Azure DevOps Server. Você também pode usar o comando de coleção para duplicar o banco de dados de uma coleção existente, renomeá-lo e anexá-lo à implantação. Às vezes, esse processo é chamado de clonagem de coleção.

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

Opção	Descrição
anexar	Obrigatório se nem /detach nem /delete for usado. Se você especificar essa opção, também deverá usar a opção /collectionDB . Como opção, você também pode usar /collectionName e /clone com essa opção. Se você usar a opção /attach, o banco de dados de coleção especificado será adicionado à implantação de Azure DevOps Server.
create	Cria uma coleção.
detach	Obrigatório se nem /attach nem /delete for usado. Se você especificar essa opção, também deverá usar a opção /collectionName . Se você usar a opção /detach, o banco de dados da coleção especificada será interrompido e a coleção será desanexada da implantação de Azure DevOps Server.
excluir	Obrigatório se nem /detach nem /attach for usado. Se você especificar essa opção, também deverá usar a opção /collectionName . Se você usar a opção /delete, o banco de dados da coleção especificada será interrompido e a coleção será permanentemente desanexada do Azure DevOps Server. Você não poderá anexar novamente o banco de dados da coleção a esta ou a qualquer outra implantação.
CollectionName	Especifica o nome da coleção de projetos. Se o nome da coleção apresentar espaços, você deverá colocá-lo entre aspas (por exemplo, "Minha Coleção"). Obrigatório se /detach ou /delete for usado. Se você usar essa opção com /detach ou /delete, ela especificará a coleção que será desanexada ou excluída. Se você usar essa opção com /attach, ela especificará um novo nome para a coleção. Se você usar essa opção com /attach e /clone, ela especificará o nome da coleção duplicada.
CollectionDB	Obrigatório se /attach for usado. Essa opção especifica o nome do servidor que está executando SQL Server e o nome do banco de dados de coleção hospedado nesse servidor.
ServerName	Especifica o nome do servidor que hospeda o banco de dados de configuração para Azure DevOps Server e o nome da instância se você quiser usar uma instância diferente da instância padrão. Se você especificar uma instância, deverá usar o formato: `ServerName\InstanceName`.
DatabaseName	Especifica o nome do banco de dados de configuração. Por padrão, o nome desse banco de dados é TFS_ConfigurationDB.
clone	Se você especificar essa opção, o banco de dados da coleção original será anexado como um clone no SQL Server e esse banco de dados será anexado a Azure DevOps Server. Essa opção é usada principalmente como parte da divisão de uma coleção de projetos.

Dica

A opção /delete não excluirá o banco de dados de coleção do SQL Server. Depois de excluir o banco de dados de coleção do Azure DevOps Server, você pode excluir o banco de dados manualmente do SQL Server.

Pré-requisitos

Para usar o comando coleções , você deve ser membro do grupo de segurança Administradores do Team Foundation, bem como do grupo administradores local no computador que executa o TfsConfig. Você também deve ser membro da função de segurança sysadmin para todas as instâncias de SQL Server usadas por bancos de dados Azure DevOps Server. Se sua implantação estiver integrada ao SharePoint e você estiver usando a opção /delete , também deverá ser membro do grupo Administradores de Farm para o farm do SharePoint do qual você está excluindo o conjunto de sites.

Para obter mais informações, consulte Referência de permissão para Azure DevOps Server.

Comentários

Para gerenciar coleções interativamente ou criar uma coleção, você pode usar o nó Coleções de Projetos no console de administração do Azure DevOps. Consulte Gerenciar coleções de projetos.

Exemplos

O exemplo a seguir mostra como remover permanentemente a Contoso Summer Intern Projects coleção de projetos de uma implantação de 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.

O exemplo a seguir mostra como duplicar a coleção de Contoso Summer Interns Projects projetos, nomeá-la Contoso Winter Interns Projectse anexar a coleção duplicada à implantação de Azure DevOps Server.

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

ColumnStoreIndex

Observação

Disponibilidade de comando: requer o TFS 2015.2 e versões posteriores.

Use o comando columnStoreIndex para habilitar ou desabilitar índices de repositório de colunas para os bancos de dados usados pela implantação do Azure DevOps Server.

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

Opção	Descrição
Habilitado	Especifica se você está habilitando ou desabilitando o índice do repositório de colunas para a instância e o banco de dados SQL fornecidos.
sqlInstance	Especifica o nome do servidor que hospeda o banco de dados para o qual o índice do repositório de colunas está sendo habilitado ou desabilitado e o nome da instância se uma instância diferente do padrão for usada. Se você especificar uma instância, deverá usar o formato: `ServerName\InstanceName`.
databaseName	Especifica o nome do banco de dados para o qual o índice do repositório de colunas está sendo habilitado ou desabilitado.

Pré-requisitos

Para usar o comando columnStoreIndex, você deve ser um membro da função sysadmin para a instância de SQL Server especificada.

Comentários

Normalmente, você usaria o comando columnStoreIndex se estivesse movendo um banco de dados de uma instância SQL que tinha suporte para o índice de repositório de colunas para um que não o fez. Nesse caso, você precisaria desabilitar todos os índices do repositório de colunas antes de poder mover os bancos de dados com êxito. Da mesma forma, se você estivesse movendo um banco de dados de volta para uma instância SQL com suporte para o índice de repositório de colunas, talvez você queira reabilitar o índice do repositório de colunas para economizar espaço e obter desempenho.

Exemplo

O exemplo a seguir mostra como habilitar o índice do repositório de colunas para um banco de dados chamado TFS_DefaultCollection em uma instância SQL em execução em um servidor chamado ContosoMain na instância TeamDatabasesnomeada .

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

ConfigureMail

Configure o servidor que executa Azure DevOps Server para usar um servidor SMTP existente para alertas de email.

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

Opção	Descrição
FromEmailAddress	Especifica o endereço do qual enviar notificações por email de Azure DevOps Server para um marcar, item de trabalho atribuído a você ou outras notificações. Esse endereço também é verificado quanto à validade e, dependendo da configuração do servidor, pode ter que representar uma conta de email válida no servidor de email. Se o endereço não existir ou não for válido, o endereço de email padrão será usado.
SmtpHost	Especifica o nome do servidor que hospeda o servidor de email.

Opção

Descrição

FromEmailAddress

Especifica o endereço do qual enviar notificações por email de Azure DevOps Server para um marcar, item de trabalho atribuído a você ou outras notificações. Esse endereço também é verificado quanto à validade e, dependendo da configuração do servidor, pode ter que representar uma conta de email válida no servidor de email. Se o endereço não existir ou não for válido, o endereço de email padrão será usado.

SmtpHost

Especifica o nome do servidor que hospeda o servidor de email.

Pré-requisitos

Para usar o comando configureMail , você deve ser membro do grupo de segurança Administradores do Team Foundation no servidor da camada de aplicativo do Azure DevOps. Para obter mais informações, consulte Referência de permissão para Azure DevOps Server

Comentários

Você também pode usar o console de administração para configurar Azure DevOps Server para usar um servidor SMTP.

Exemplo

O exemplo a seguir mostra a sintaxe usada para configurar o do endereço de email para TFS@contoso.com e o servidor de email SMTP como ContosoMailServer:

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

DBCompression

Use o comando dbCompression para habilitar ou desabilitar a compactação de página de banco de dados para os bancos de dados usados pela implantação do Azure DevOps Server.

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

Opção	Descrição
pageCompression	Especifica se você está habilitando ou desabilitando a compactação de página para a instância e o banco de dados SQL especificados.
sqlInstance	Especifica o nome do servidor que hospeda o banco de dados para o qual a compactação de página está sendo habilitada ou desabilitada e o nome da instância se uma instância diferente do padrão for usada. Se você especificar uma instância, deverá usar o formato : `ServerName\InstanceName`
databaseName	Especifica o nome do banco de dados para o qual a compactação de página está sendo habilitada ou desabilitada.
rebuildNow	Opcional. Especifica se os índices de banco de dados devem ser recriados (e compactados ou descompactados conforme necessário) imediatamente. Se não forem usados, os índices serão recriados por um trabalho em segundo plano que é executado semanalmente.
offline	Opcional. Usado somente em combinação com /rebuildNow. Se /offline não for especificado, os índices serão recriados online. Se /offline for especificado, os índices serão recriados offline. Isso bloqueará outras operações, mas pode ser mais rápido do que uma recompilação de índice online.

Pré-requisitos

Para usar o comando dbCompression, você deve ser um membro da função sysadmin para a instância de SQL Server especificada.

Comentários

Normalmente, você usaria o comando dbCompression se estivesse movendo um banco de dados de uma instância do SQL com suporte para uma que não o fez. Nesse caso, você precisaria desabilitar a compactação e descompactar todos os índices antes de poder mover os bancos de dados com êxito. Da mesma forma, se você estivesse movendo um banco de dados de volta para uma instância do SQL com suporte para compactação, talvez você queira reabilitar a compactação para economizar espaço.

Esse comando só muda se Azure DevOps Server prefere usar a compactação de página do banco de dados ou não – seus bancos de dados ainda devem ser hospedados em uma instância sql cuja edição dá suporte à compactação. Consulte Recursos compatíveis com as edições de SQL Server para obter mais informações.

Exemplo

O exemplo a seguir mostra como habilitar a compactação de página imediatamente, com índices recriados online, para um banco de dados chamado TFS_DefaultCollection em uma instância SQL em execução em um servidor chamado ContosoMain na instância TeamDatabasesnomeada .

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

DeleteTestResults

Use o comando deleteTestResults para excluir resultados antigos de teste armazenados do repositório de coleções. Normalmente, isso é feito para reduzir o tamanho do repositório ou reduzir o tempo gasto ao migrar os resultados do teste para um novo esquema.

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

Opção	Descrição
ageInDays	Os resultados do teste mais antigos do que o número especificado de dias serão excluídos ou visualizados.
sqlInstance	O nome do servidor que hospeda o banco de dados para o qual os resultados do teste estão sendo excluídos ou visualizados e o nome da instância se uma instância diferente do padrão for usada. Se você especificar uma instância, deverá usar o formato: `ServerName\InstanceName`.
databaseName	O nome do banco de dados para o qual os resultados do teste estão sendo excluídos ou visualizados.
tipo	Opcional. O tipo de resultados de teste a serem excluídos. Os valores válidos são automatizados, manuais e todos.
preview	Opcional. Exiba o número de resultados do teste que seriam excluídos com base na idade em dias, mas não exclua esses resultados.

Pré-requisitos

Para usar o comando deleteTestResults, você deve ser um membro da função sysadmin para a instância de SQL Server especificada.

Comentários

Use o parâmetro /preview para ver os resultados do teste classificados por nome do projeto e ano sem excluir esses resultados.

Exemplo

O exemplo a seguir mostra como excluir resultados manuais de teste com mais de 60 dias para um banco de dados chamado TFS_DefaultCollection em uma instância SQL em execução em um servidor chamado ContosoMain na instância TeamDatabasesnomeada .

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

DeploymentPool

O comando deploymentPool foi projetado para migrar todos os grupos de implantação de um pool de implantação para outro.

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

Opção	Descrição
fromPool	Nome do pool de origem.
toPool	Nome do pool de destino.

Identidades

O comando de identidades lista ou altera o SID (identificador de segurança) de usuários e grupos na implantação de Azure DevOps Server. Talvez seja necessário alterar ou atualizar o SID para usuários e grupos em um dos seguintes cenários:

Alterando o domínio da implantação
Alterando de um grupo de trabalho para um domínio ou de um domínio para um grupo de trabalho
Migrando contas entre domínios no Active Directory

Observação

Você não precisará executar esse comando se estiver alterando domínios na mesma floresta do Active Directory. Azure DevOps Server manipulará automaticamente as alterações de SID para movimentações na mesma floresta.

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

Opção	Descrição
alterar	Especifica que você deseja alterar identidades em vez de listá-las.
fromdomain	Necessário ao usar /change. Especifica o domínio original das identidades que você deseja alterar. Se você estiver mudando de um ambiente de grupo de trabalho, especificará o nome do computador.
todomain	Necessário ao usar /change. Especifica o domínio para o qual você deseja alterar identidades. Se você estiver alterando para um ambiente de grupo de trabalho, especificará o nome do computador.
account	Especifica o nome de uma conta para a qual você deseja listar ou alterar identidades.
toaccount	Especifica o nome de uma conta para a qual você deseja alterar identidades.
SQLInstance	Especifica o nome do servidor que está executando SQL Server e o nome da instância se você quiser usar uma instância diferente da instância padrão. Se você especificar uma instância, use o seguinte formato: NomeDoServidor\NomeDaInstância
DatabaseName	Especifica o nome do banco de dados de configuração para Azure DevOps Server.

Pré-requisitos

Para usar o comando de identidades, você deve ser membro do grupo de segurança Administradores do Team Foundation e membro da função sysadmin para todas as instâncias de SQL Server que o Team Foundation Server usa. Para obter mais informações, consulte Definir permissões de administrador para Azure DevOps Server.

Comentários

Opcionalmente, você pode especificar o banco de dados para alterar identidades antes de configurar um servidor da camada de aplicativo para a implantação. Por exemplo, você pode especificar o banco de dados para alterar a conta de serviço ao clonar uma implantação de Azure DevOps Server.

Quando você altera identidades, a conta de destino ou as contas já devem existir no Windows.

Você deve aguardar a próxima sincronização de identidade com o Windows antes que as propriedades das contas alteradas com esse comando sejam atualizadas. Esse requisito inclui alterações de grupo para usuário, usuário para grupo e conta de domínio para conta local.

Exemplos

O exemplo a seguir mostra como listar os nomes de todos os usuários e grupos do Windows armazenados em Azure DevOps Server e exibir se o SID de cada usuário ou grupo corresponde ao SID no Windows. Os administradores de domínio contoso1 criaram grupos de domínio como Contoso1\\Developers e Contoso1\\Testers para ajudar a facilitar o gerenciamento de permissões em Azure DevOps Server, SQL Server Reporting Services e produtos do 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.

O exemplo a seguir mostra como alterar os SIDs de todas as contas no Azure DevOps Server do domínio Contoso1 para os SIDs para contas que têm nomes correspondentes no ContosoPrime domínio. Somente os nomes de conta correspondentes terão seus SIDs atualizados. Por exemplo, se a hholt conta existir como Contoso1\hholt e ContosoPrime\hholt, o SID da conta será alterado para o SID de ContosoPrime\hholt. Se a ContosoPrime\hholt conta não existir, o SID não será atualizado para Contoso1\hholt.

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

O exemplo a seguir mostra como alterar a conta de uma única conta de usuário, Contoso1\hholt, para a conta de outra conta de usuário, ContosoPrime\jpeoples.

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

O exemplo a seguir mostra como alterar o SID da conta de NT AUTHORITY\NETWORK SERVICE serviço usada na implantação de Azure DevOps Server ao alterar o domínio da implantação de Contoso1 para ContosoPrime. Para alterar uma conta do sistema, como o Serviço de Rede, você deve seguir um processo de dois estágios. Primeiro, altere a conta de serviço de NT AUTHORITY\NETWORK SERVICE para uma conta de domínio no novo domínio TempSVCe, em seguida, altere a conta de volta para NETWORK SERVICE no servidor no novo domínio. O banco de dados de configuração é hospedado no servidor nomeado ContosoMain na instância TeamDatabases nomeada no 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"

Trabalhos

Você pode usar o comando jobs para criar um arquivo de log que fornece os detalhes da atividade de trabalho mais recente para uma coleção de projetos específica ou para repetir um trabalho para uma ou todas as coleções de projetos.

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

Opção	Descrição
tentar novamente	Obrigatório se /dumplog não for usado. Especifica que o trabalho mais recente será reattempted para a coleção de projetos especificada. Se você usar essa opção, também deverá usar a opção /CollectionName ou /CollectionID .
dumplog	Obrigatório se /retry não for usado. Especifica que a atividade de trabalho mais recente para a coleção será enviada para um arquivo de log. Se você usar essa opção, também deverá usar a opção /CollectionName ou /CollectionID .
CollectionName	Obrigatório se /CollectionID não for usado. Especifica o nome da coleção para a qual o trabalho mais recente será repetido (/tentar novamente) ou registrado (/dumplog). Se você quiser especificar todas as coleções, poderá usar um asterisco (*).
CollectionID	Obrigatório se /CollectionName não for usado. Especifica o número de identificação da coleção para a qual o trabalho mais recente será repetido (/tentar novamente) ou registrado (/dumplog).

Pré-requisitos

Para usar o comando trabalhos , você deve ser membro do grupo de segurança Administradores do Azure DevOps. Para obter mais informações, consulte Referência de permissão para Azure DevOps Server.

Comentários

Para repetir um trabalho interativamente, você pode abrir o console de administração do Azure DevOps, selecionar a guia Status da coleção e, em seguida, selecionar Repetir Trabalho. Para obter mais informações, consulte Abrir o Console de Administração do Azure DevOps.

Exemplo

O exemplo a seguir mostra como criar um arquivo de log que lista a atividade de trabalho mais recente para a coleção de Contoso Summer Intern Projects projetos em Azure DevOps Server.

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

OfflineDetach

Use o comando offlineDetach para transformar um banco de dados de coleção offline em um banco de dados de coleção offline desanexado.

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

Opção	Descrição
configurationDB	Especifica o nome do banco de dados de configuração a ser usado.
collectionDB	Especifica o nome do banco de dados de coleção a ser desanexado.

Pré-requisitos

Para usar o comando offlineDetach, você deve ser um membro da função sysadmin para a instância de SQL Server especificada.

Comentários

Esse comando modifica o esquema do banco de dados de coleção especificado e nunca deve ser executado em bancos de dados que estão em uso por uma implantação do Team Foundation Server. Se os bancos de dados estiverem em uso por uma implantação do Team Foundation Server, use TfsConfig collection /detach em vez disso.

Esse comando é útil quando você precisa restaurar um banco de dados de coleção individual do backup sem restaurar outros bancos de dados de coleção que fazem parte do mesmo Azure DevOps Server implantação. Anteriormente, isso exigia a restauração de um conjunto completo e consistente de bancos de dados (configuração e todas as coleções) para um ambiente de preparo, configuração de uma implantação de Azure DevOps Server usando esses bancos de dados e desanexação de uma coleção de interesses.

Em vez disso, agora você pode restaurar cópias consistentes do banco de dados de configuração e do banco de dados de coleção de interesse e executar o comando offlineDetach . Em seguida, o banco de dados de coleção desanexado pode ser anexado a qualquer implantação Azure DevOps Server em uma versão apropriada.

Exemplo

O exemplo a seguir ilustra a desanexação de um banco de dados de coleção chamado TFS_PrimaryCollection, usando um banco de dados de configuração chamado TFS_Configuration, com ambos em uma instância SQL em execução em um servidor chamado ContosoTemp na instância Backupsnomeada .

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

Proxy

Você pode usar o comando proxy para atualizar ou alterar as configurações usadas pelo Servidor Proxy do Azure DevOps. O Servidor Proxy do Azure DevOps fornece suporte para equipes distribuídas usarem o controle de versão gerenciando um cache de arquivos de controle de versão baixados no local da equipe distribuída. Ao configurar o Servidor Proxy do Azure DevOps, você pode reduzir significativamente a largura de banda necessária em conexões de longa distância. Além disso, você não precisa gerenciar o download e o cache de arquivos de versão; O gerenciamento dos arquivos é transparente para o desenvolvedor que está usando os arquivos. Enquanto isso, todas as trocas de metadados e uploads de arquivo continuam aparecendo em Azure DevOps Server. Se você usar o Azure DevOps Services para hospedar seu projeto de desenvolvimento na nuvem, poderá usar o comando Proxy para não apenas gerenciar o cache para projetos na coleção hospedada, mas também para gerenciar algumas das configurações usadas por esse serviço.

Para obter mais informações sobre como instalar o Servidor Proxy do Azure DevOps e a configuração inicial do proxy,

consulte Como instalar o Servidor Proxy do Azure DevOps e configurar um site remoto. Para obter mais informações sobre como configurar o proxy em computadores cliente, consulte Referência de comando de controle de versão do Azure DevOps.

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

Opção	Descrição
add	Adiciona o servidor ou coleção especificado à lista de proxy no arquivo Proxy.config. Você pode executar /add várias vezes para incluir mais coleções ou servidores. Ao usar /add com uma coleção hospedada em Azure DevOps Services, você será solicitado a fornecer suas credenciais em Azure DevOps Services.
alterar	Altera as credenciais armazenadas como a conta de serviço para Azure DevOps Services. A opção /change é usada apenas para Azure DevOps Services; ela não deve ser usada para implantações locais de Azure DevOps Server.
excluir	Remove o servidor ou coleção especificado da lista de proxy no arquivo Proxy.config.
account	Especifica a conta usada como a conta de serviço para o proxy no Azure DevOps Services. Essa opção só é usada para Azure DevOps Services em conjunto com a opção /change. A conta de serviço padrão usada para Azure DevOps Services é "Serviço de Conta".
continue	Continua a execução do comando mesmo que o processo de verificação produza avisos.
Coleção	Especifica a URL da coleção de projetos hospedada em Azure DevOps Services, no `AccountName.DomainName/CollectionName` formato .
account	Especifica o nome da conta usada como a conta de serviço para Azure DevOps Services. Se o nome da conta tiver espaços, o nome deverá estar entre aspas (""). Todos os caracteres especiais em nomes de conta devem ser especificados de acordo com a sintaxe de linha de comando.
account	Especifica a URL de uma implantação de Azure DevOps Server, em `ServerURL:Port/tfs` formato.
PersonalAccessTokenFile	Opcionalmente, especifica o caminho para um arquivo que contém um token de acesso pessoal. Esse token será usado para autenticar na coleção ou conta ao registrar um proxy. (Adicionado no TFS 2018 Atualização 1)
entradas	Opcional. Especifica configurações e valores adicionais a serem usados ao configurar o proxy.! Por exemplo, valores para `GvfsProjectName` e `GvfsRepositoryName` podem ser usados para configurar um repositório Git para uso com o Git Virtual File System (GVFS) (adicionado no TFS 2018 Atualização 1)

Pré-requisitos

Para usar o comando proxy , você deve ser um membro do grupo de segurança Administradores do Azure DevOps e um administrador no servidor proxy. Para obter mais informações, consulte Referência de permissão para Azure DevOps Server.

Comentários

Use o comando proxy para atualizar a configuração existente do proxy Azure DevOps Server. Não é possível usar o comando proxy para instalação inicial e configuração do proxy.

Exemplos

O exemplo a seguir mostra como adicionar uma implantação de Azure DevOps Server chamada FABRIKAM à lista de proxy.

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

O exemplo a seguir mostra como adicionar uma coleção de projetos hospedada em Azure DevOps Services à lista de proxy usando um Token de Acesso Pessoal para autenticar. Esse token será usado apenas para registrar o proxy com a conta Azure DevOps Services – a conta de serviço padrão ainda será usada para executar o proxy. Esse parâmetro foi adicionado no TFS 2018 Atualização 1 para dar suporte ao registro de um Proxy com Azure DevOps Services sem a necessidade de um prompt de logon.

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

O exemplo a seguir mostra como adicionar uma coleção de projetos à lista de proxy. Este exemplo usa um token de acesso pessoal para autenticar na coleção especificada com o /Collection parâmetro . O token de acesso pessoal a ser usado é salvo em um arquivo em c:\PersonalAccessToken.txt.

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

O exemplo a seguir mostra como alterar a conta de serviço usada pelo proxy para a coleção de projetos hospedada no Azure DevOps Services. A coleção é chamada PhoneSaver, o nome da conta usado para Azure DevOps Services é HelenaPetersen.fabrikam.come a conta de serviço usada pelo proxy está sendo alterada para My Proxy Service Account. Como o nome da conta contém espaços, as aspas são usadas para colocar o nome entre eles.

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

O exemplo a seguir mostra como adicionar um repositório Git para uso com o GVFS.

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

RebuildWarehouse

Você pode usar o comando rebuildWarehouse para recompilar os bancos de dados SQL Server Reporting Services e SQL Server Analysis Services que Azure DevOps Server usa.

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

Opção	Descrição
Analysisservices	Obrigatório se /all não for usado. Especifica que somente o banco de dados do Analysis Services será recriado. Se nenhum banco de dados existir para o Analysis Services, você também deverá usar a opção /reportingDataSourcePassword .
all	Obrigatório se /analysisServices não for usado. Especifica que todos os bancos de dados de relatório e análise que Azure DevOps Server usa serão recriados.
reportingDataSourcePassword	Obrigatório se o banco de dados TFS_Analysis não existir. Especifica a senha da conta usada como a conta de fontes de dados para SQL Server Reporting Services (TFSReports). Para obter mais informações, consulte Contas de serviço e dependências no Azure DevOps Server.

Pré-requisitos

Para usar o comando rebuildWarehouse , você deve ser membro dos seguintes grupos:

O grupo de segurança Administradores do Azure DevOps e o grupo de segurança Administradores no servidor ou servidores que estão executando o console de administração do Azure DevOps
O grupo sysadmin no servidor ou servidores que estão executando a instância de SQL Server que hospeda os bancos de dados para Azure DevOps Server

Para obter mais informações, consulte Referência de permissão para Azure DevOps Server.

Comentários

Você pode usar esse comando ao mover ou dividir uma coleção de projetos, restaurar dados ou alterar a configuração da implantação.

Para iniciar a recompilação desses bancos de dados interativamente, você pode usar o nó Relatório no console de administração do Azure DevOps. Para obter mais informações, consulte Abrir o Console de Administração do Azure DevOps.

Exemplo

O exemplo a seguir mostra como recompilar o banco de dados do Analysis Services para uma implantação de 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

Use registerDB para atualizar o nome do servidor que hospeda o banco de dados de configuração no Azure DevOps Server. Você pode usar esse comando ao restaurar o banco de dados de configuração para um novo hardware ou ao alterar o domínio de uma implantação.

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

Opção	Descrição
SQLInstance	Obrigatórios. Especifica o nome do servidor que está executando SQL Server e o nome da instância se você quiser usar uma instância diferente da instância padrão. Se você especificar uma instância, deverá usar o formato: `ServerName\InstanceName`.
databaseName	Obrigatórios. Especifica o nome do banco de dados de configuração. Por padrão, isso é Tfs_Configuration.

Pré-requisitos

Para usar o comando registerDB, você deve ser membro do grupo Administradores do Azure DevOps no servidor da camada de aplicativo do Azure DevOps e membro do grupo sysadmin no SQL Server no servidor da camada de dados do Azure DevOps. Para obter mais informações, consulte Referência de permissão para Azure DevOps Server.

Comentários

Faça backup dos bancos de dados para Azure DevOps Server antes de usar esse comando.

Para que o comando registerDB tenha êxito, os seguintes pools de aplicativos e programas devem estar em execução:

Pool de Aplicativos Azure DevOps Server (pool de aplicativos)
ReportServer (pool de aplicativos)
SQL Server Reporting Services (programa)

Você deve fornecer o nome ou endereço exato do banco de dados de configuração para que esse comando opere corretamente. Se você precisar alterar o servidor no qual esse banco de dados está armazenado, verifique se Azure DevOps Server aponta para o novo local.

Exemplo

O exemplo a seguir redireciona Azure DevOps Server para um banco de dados de configuração localizado no servidor ContosoMain na instância TeamDatabasesSQL Server .

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

Remapdbs

O comando remapDBs redireciona Azure DevOps Server para seus bancos de dados quando eles são armazenados em mais de um servidor e você está restaurando, movendo ou alterando a configuração da implantação. Por exemplo, você deve redirecionar Azure DevOps Server para todos os bancos de dados para coleções de projetos se eles estiverem hospedados em um servidor ou servidor separado do banco de dados de configuração. Você também deve redirecionar Azure DevOps Server para o servidor ou servidores que estão executando SQL Server Analysis Services ou SQL Server Reporting Services se esses bancos de dados estiverem hospedados em um servidor ou instância separado do banco de dados de configuração.

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

Opção	Descrição
DatabaseName	Especifica o nome do servidor que hospeda o banco de dados que você deseja mapear para Azure DevOps Server, além do nome do próprio banco de dados.
SQLInstances	Especifica o nome do servidor que está executando SQL Server, além do nome da instância se você quiser usar uma instância diferente da instância padrão. Se você estiver especificando mais de um servidor, deverá usar uma vírgula para separar vários pares de nomes de servidor e de instância.
AnalysisInstance	Opcional. Especifica o nome do servidor e da instância que hospeda SQL Server Analysis Services. Use essa opção para especificar o servidor e a instância que hospeda o banco de dados do Analysis Services.
AnalysisDatabaseName	Opcional. Especifica o nome do banco de dados do Analysis Services que você deseja usar com Azure DevOps Server se você tiver mais de um banco de dados desse tipo no servidor especificado com a opção /AnalysisInstance.
preview	Opcional. Exibe as ações que você deve executar para atualizar a configuração.
continue	Opcional. Especifica que o comando RemapDB deve continuar mesmo se ocorrer um erro durante a tentativa de localizar um ou mais bancos de dados. Se você usar a opção /continue , todas as coleções cujos bancos de dados não forem encontrados no servidor ou nos servidores especificados serão reconfiguradas para usar o servidor e a instância que hospedam o banco de dados de configuração.

Pré-requisitos

Para usar o comando remapDBs, você deve ser membro do grupo de segurança Administradores do Azure DevOps e membro do grupo de segurança sysadmin para qualquer banco de dados SQL Server que Azure DevOps Server usa. Para obter mais informações, consulte Referência de permissão para Azure DevOps Server.

Comentários

Use o comando remapDBs para reconfigurar Azure DevOps Server para usar diferentes servidores e instâncias de SQL Server dos servidores e instâncias na instalação original.

Exemplo

O exemplo a seguir mostra como redirecionar Azure DevOps Server para seu banco de dados TFS_Configurationde configuração . Esse banco de dados está hospedado no ContosoMain na instância TeamDatabasesnomeada . Seus bancos de dados de coleção de projetos são armazenados em ContosoMain\TeamDatabases e na instância padrão em Contoso2.

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

RepairJobQueue

Use o comando repairJobQueue para corrigir trabalhos agendados que pararam de ser executados para hosts de implantação e coleção.

TfsConfig repairJobQueue

Pré-requisitos

Para usar o comando repairJobQueue , você deve ser membro do grupo de administradores locais no computador que executa o TfsConfig. Você também deve ser membro da função de segurança sysadmin para todas as instâncias de SQL Server usadas pela implantação do Azure DevOps Server.

Comentários

Normalmente, você usaria o comando repairJobQueue se percebesse que os trabalhos agendados não estão em execução.
O comando não aceita argumentos e requer que a implantação Azure DevOps Server seja configurada.

Exemplo

TfsConfig repairJobQueue

Settings

Você pode usar o comando de configurações para automatizar alterações no URL (uniform resource locator) usado pela interface de notificação e para o endereço do servidor para Azure DevOps Server. Por padrão, a URL da interface de notificação e a URL do servidor correspondem em Azure DevOps Server, mas você pode configurar URLs separadas. Por exemplo, talvez você queira usar uma URL diferente para os emails automáticos gerados Azure DevOps Server. Você deve executar essa ferramenta na camada de aplicativo para atualizar todos os servidores para que eles usem as novas URLs.

Para alterar essas URLs interativamente ou apenas para exibir as configurações atuais, você pode usar o console de administração do Azure DevOps. Consulte Referência rápida da tarefa administrativa.

TfsConfig settings [/publicURL:URL]

Opção	Descrição
publicUrl	Especifica a URL do servidor da camada de aplicativo para o Azure DevOps. Esse valor é armazenado no banco de dados de configuração do Azure DevOps.

Pré-requisitos

Você deve ser membro do grupo de segurança Administradores do Azure DevOps e do grupo Administradores no servidor da camada de aplicativo. Para obter mais informações, consulte Definir permissões de administrador para Azure DevOps Server.

Comentários

O comando settings altera as informações de conexão para comunicação de servidor para servidor em uma implantação de Azure DevOps Server. A URL especificada em /publicURL deve estar disponível para todos os servidores dentro da implantação.

Exemplo

O exemplo a seguir altera o valor de NotificationURL para http://contoso.example.com/tfs e o valor de ServerURL para http://contoso.example.com:8080/tfs.

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

Instalação

Use o comando de instalação para desinstalar recursos que estão atualmente configurados no computador em que você executa o comando.

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

Opção

Descrição

/uninstall

Especifica um ou mais recursos a serem desinstalados do computador em que você executa o comando. As opções incluem: All, ApplicationTier, Pesquisa e VersionControlProxy.

Pré-requisitos

Para usar o comando de instalação , você deve ser membro do grupo de segurança Administradores do Azure DevOps.

Exemplos

O exemplo a seguir desinstala todos os recursos Azure DevOps Server do computador atual.

TfsConfig setup /uninstall:All

O exemplo a seguir desinstala a camada de aplicativo e os recursos de build do computador atual.

TfsConfig setup /uninstall:ApplicationTier

TCM

Ao atualizar para a versão mais recente do Azure DevOps Server, o sistema tenta atualizar automaticamente os componentes do Gerenciamento de Testes, incluindo planos de teste e pacotes.

Se a migração automática falhar, use o comando TCM para atualizar seus planos de teste e conjuntos de testes manualmente para seus respectivos WITs (tipos de item de trabalho).

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

Opção

Descrição

/upgradeTestPlans

Obrigatório, a menos que /upgradeStatus seja usado.

Converte o plano e os pacotes de teste existentes para os planos e pacotes de teste baseados em item de trabalho. Também atualiza os dados de gerenciamento de teste existentes e os links entre outros artefatos de teste existentes, como pontos, execuções e resultados de teste.

/upgradeStatus

Obrigatório, a menos que /upgradeTestPlans seja usado.

Relata o status de migração de dados de teste para o projeto especificado. Também indica se o projeto especificado tem algum plano de teste.

/CollectionName:CollectionName

Obrigatórios. Especifica a coleção de projetos que contém o projeto para o qual você deseja migrar dados de teste ou marcar a status de migração.

Se houver espaços no nome da coleção de projetos, coloque o nome entre aspas, por exemplo, "Coleção de Fibras fabrikam".

/TeamProjectName:TeamProjectName

Obrigatórios. Especifica o projeto para o qual você deseja migrar dados de teste ou marcar a status de migração. Esse projeto deve ser definido na coleção que você especificou usando o parâmetro /collectionName .

Se houver espaços no nome do projeto, coloque o nome entre aspas, por exemplo, "Meu Projeto".

Pré-requisitos

Você deve ser membro do grupo de segurança Team Foundation Administrators ou um administrador no servidor de nível de aplicativo.

Consulte Definir permissões de administrador para Azure DevOps Server.

Comentários

O servidor da camada de aplicativo deve ser atualizado para a versão mais recente do Azure DevOps Server 2019 para usar esse comando.

Antes de poder usar o comando TCM, é preciso primeiro importar a definição do item de trabalho do plano de teste e a categoria do plano de teste para o projeto.

Para saber mais sobre a migração e quando usar esse comando, confira Atualizações manuais para dar suporte ao gerenciamento de testes.

O comando TCM é aplicado a projetos individuais. Se você precisar atualizar os planos de teste em mais de um projeto, precisará executá-lo em cada projeto individualmente.

Você deve executar o comando TCM no diretório de ferramentas para Azure DevOps Server. Por padrão, esse local é: drive:\%programfiles%\TFS 12.0\Tools.

Use o comando TCM somente caso a migração automática de dados de teste existentes falhe.

Para saber mais sobre a migração e quando usar esse comando, atualizações manuais para dar suporte ao gerenciamento de testes. Se você não puder acessar planos de teste ou conjuntos de testes que foram definidos antes da atualização do servidor, execute TFSConfig TCM upgradeStatus para determinar o status da migração.

Execute o comando TCM para um projeto individual. Se você precisar atualizar mais de um projeto, precisará executá-lo em cada projeto por sua vez.

Exemplos

O exemplo a seguir mostra como marcar o status de atualização do plano de teste no projeto Fabrikam Fiber hospedado na coleção de projetos padrão (DefaultCollection):

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

Unattend

Disponibilidade do comando: Azure DevOps Server 2019

O comando unattend foi projetado para usuários que estão familiarizados com Azure DevOps Server e o processo de configuração e que precisam instalar Azure DevOps Server em computadores diferentes.

Por exemplo, se você usar o Build do Azure DevOps, poderá usar o comando autônomo para instalar vários servidores de build usando o mesmo arquivo de configuração.

Use a opção /create para criar um arquivo sem atenção. Esse arquivo define todos os parâmetros de configuração para uma instalação Azure DevOps Server. Em seguida, use a opção /configure para realmente executar a configuração.

Esse processo permite configurar Azure DevOps Server do início ao fim sem precisar fornecer entrada durante o processo de instalação. No caso de várias instalações, isso ajuda também a garantir que exatamente os mesmos parâmetros de configuração sejam usados em vários servidores.

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

Opção	Descrição
create	Cria o arquivo autônomo com o nome e os parâmetros especificados.
CONFIGURAR	Configura Azure DevOps Server usando o arquivo e os parâmetros que você especificar. Você deve usar /type ou /unattendfile com essa opção.
tipo	Especifica o tipo de configuração a ser usado. Quando você usa /configure, /type ou /unattendfile são necessários, mas não é possível usar ambos.
unattendfile	Especifica o arquivo autônomo a ser criado ou usado, dependendo se o parâmetro inicial for /create ou /configure. Ao usar /configure, /unattendfile ou /type se tornam necessários.
entradas	Opcional. Se usar /create, especifica as configurações e os valores a serem usados ao criar o arquivo autônomo. Se usar /configure, especifica as configurações e os valores adicionais a serem usados em conjunto com o arquivo autônomo. Como uma alternativa ao uso de /inputs, é possível editar manualmente o arquivo autônomo em qualquer editor de texto simples. Isso é necessário para determinados tipos de entrada, como ServiceAccountPassword ou PersonalAccessToken, pois esses valores secretos não podem ser definidos usando o parâmetro /inputs.
verificar	Opcional. Especifica uma execução de configuração que conclui apenas verificações de verificação com base no arquivo, nas entradas e no tipo de configuração não atenuados. Essa é uma alternativa para executar uma configuração completa.
continue	Opcional. Especifica que /create ou /configure deve continuar, independentemente dos avisos de verificações.

InstallType	Descrição
NewServerBasic	Configura os serviços de desenvolvimento essenciais para Azure DevOps Server. Isso inclui Controle do Código-Fonte, Itens de Trabalho, Build e, opcionalmente, Pesquisa.
NewServerAdvanced	Configura os serviços de desenvolvimento essenciais e permite a configuração opcional de integração com Reporting Services.
Atualização	Atualiza Azure DevOps Server para a versão atual de uma versão anterior com suporte.
PreProductionUpgrade	Teste a atualização em uma implantação de Azure DevOps Server existente em um ambiente de pré-produção. Normalmente, isso é feito usando bancos de dados restaurados de backups de produção. Esse cenário inclui etapas adicionais para garantir que a nova implantação não interfira na implantação de produção.
ApplicationTierOnlyBasic	Configure uma nova camada de aplicativo usando as configurações existentes do banco de dados de configuração fornecido. Essa opção permite que você coloque uma nova camada de aplicativo em funcionamento rapidamente usando as configurações existentes. Se você quiser a capacidade de alterar as configurações existentes, use o tipo Avançado ApplicationTierOnlyAdvanced.
ApplicationTierOnlyAdvanced	Configure uma nova camada de aplicativo com controle total sobre todas as configurações. As configurações usarão como padrão os valores existentes do banco de dados de configuração fornecido. Se você quiser preservar todas as configurações existentes, use o tipo ApplicationTierOnlyBasic.
Clone	Configure uma nova implantação de Azure DevOps Server que é um clone de uma implantação existente. Isso normalmente é feito, usando bancos de dados restaurados de backups de produção, para criar um ambiente em que alterações de configuração, extensões e outras modificações podem ser testadas. Esse cenário inclui etapas adicionais para garantir que a nova implantação não interfira na implantação de produção.
Proxy	Configura um serviço de proxy de controle de versão.

Pré-requisitos

Você tem que ser membro do grupo Administradores no computador em que o software está instalando.
Dependendo do tipo de instalação, talvez seja necessário solicitar permissões adicionais de administrador.

Por exemplo, se você estiver usando o comando unattend para instalar Azure DevOps Server , deverá ser membro do grupo sysadmin na instância do SQL Server que dará suporte a Azure DevOps Server. Para obter mais informações, consulte a seção Q & A de Adicionar administradores no nível do servidor para Azure DevOps Server.

Comentários

Antes de usar o comando autônomo para configurar Azure DevOps Server, você deve criar as contas de serviço que usará como parte de sua implantação. Você deve também instalar qualquer software de pré-requisito para o tipo de instalação escolhido. Isso inclui Azure DevOps Server em si. Você deve instalar Azure DevOps Server mas não precisa configurá-la porque o comando não atento fará isso para você.

O comando desatento configura Azure DevOps Server componentes. Ele não executa a instalação inicial do software. Ele configura o software de acordo com suas especificações após os bits estarem presentes no computador.

Exemplos

O exemplo a seguir mostra como criar um arquivo autônomo para uma instalação básica do Azure DevOps Server.

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

Neste exemplo, o arquivo autônomo é criado no mesmo diretório do comando. Um arquivo de log é criado como parte do comando e o local do arquivo é retornado no comando como parte da execução do comando.

O exemplo a seguir mostra como especificar um repositório Git para uso com o GVFS durante a configuração.

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

O exemplo a seguir mostra como criar um arquivo autônomo para a configuração de um Servidor Proxy do Azure DevOps.

Importante

Neste exemplo, se os administradores quiserem usar um token de acesso pessoal para autenticação, eles precisarão editar manualmente o arquivo para especificar o valor do token de acesso pessoal. Isso pode ser feito adicionando uma linha para o token de acesso pessoal no arquivo não atenuado criado, como: PersonalAccessToken=PersonalAccessTokenValue.

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

O exemplo a seguir mostra como criar um arquivo sem atenção para a configuração do Azure DevOps Server Compilar em um servidor usando FabrikamFiber\BuildSVC como a conta de serviço de build e, em seguida, configurar Azure DevOps Server Build usando esse arquivo não atenuado.

Importante

Neste exemplo, depois de criar o arquivo autônomo, o administrador edita manualmente o arquivo para especificar a senha da conta de serviço de compilação. Adicionar a senha como uma entrada usando ServiceAccountPassword=Password; não adiciona as informações de senha ao arquivo.

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

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

O primeiro comando retorna o seguinte:

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

O segundo comando retorna as seguintes informações, incluindo o nome do servidor em que o Build do Azure DevOps foi configurado FabrikamFiberTFS e a coleção de projetos associada ao controlador 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

O comando ziplogs foi projetado para coletar logs e descarta um zip em ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs