Use o TFSConfig para gerenciar o Azure DevOps em ambientes locais

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

• a conta de serviço do Servidor do Azure DevOps
• as fontes de dados consideradas pelo 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 do Servidor do Azure DevOps.

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

O valor padrão é ApplicationTier.

O sqlInstance e o 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 at only.

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 a função de continuidade for fornecida, ela prosseguirá se uma coleção estiver inacessível. O programa pode ser executado novamente quando eles estiverem acessíveis.

Pré-requisitos

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

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

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

Para obter mais informações, consulte a referência de permissão para o Servidor do Azure DevOps.

Observações

Use o comando de contas para automatizar as alterações nas contas de serviço, bancos de dados e grupos de contas de serviço do Servidor do Azure DevOps. 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 permissão "Conta é sensível 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 de contas dá suporte a implantações locais do Azure DevOps Server. Para alterar o proprietário da conta de uma conta do Azure DevOps Services, consulte Alterar a propriedade da conta.

Exemplos

Altere a conta de serviço das fontes de dados do Reporting Services para uma nova conta no domínio Contoso\NewAccount, contoso, e 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 do Servidor do Azure DevOps (as contas do sistema não têm senhas).

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

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

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

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]

Pré-requisitos

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

Observações

Use o comando addProjectReports quando o projeto não tiver relatórios ou quiser 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 com relatórios padrão porque você atualizou o Servidor do Azure DevOps e os 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 um servidor do Azure DevOps 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

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

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

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 da camada de aplicativo ou servidor proxy, dependendo do valor da opção siteType .

Observações

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

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

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

Pré-requisitos

Para usar o comando certificados , você deve ser um 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 a referência de permissão para o Servidor do Azure DevOps.

Observações

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 do comando para especificar um certificado ou certificados específicos do contexto do usuário atual ou do contexto do computador local.

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

Use o comando certificados para configurar os certificados de cliente usados por uma implantação do Servidor de DevOps do Azure que foi configurada 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 nenhuma 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

O comando changeServerID altera os GUIDs associados aos bancos de dados do Azure DevOps Server. Os GUIDs devem ser exclusivos em uma implantação do Servidor do Azure DevOps. 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 após movê-lo para outra implantação onde esse GUID já está reservado.

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

Pré-requisitos

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

Observações

Use o comando changeServerID para criar uma duplicata discreta de uma implantação do Servidor de DevOps do Azure 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 do Azure DevOps Server, em que o banco de dados de configuração está hospedado no servidor nomeado ContosoMain na instância TeamDatabases nomeada no SQL Server.

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

Use o comando codeIndex para gerenciar a indexação de código no Servidor do Azure DevOps. Por exemplo, talvez você queira redefinir o índice para corrigir informações do 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>]

Pré-requisitos

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

Exemplos

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

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

Para começar a indexar 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 começar a indexar novos conjuntos de alterações apenas:

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

Para localizar 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 ignorada:

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 dados indexados anteriormente e reiniciar a indexação:

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

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

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

Para remover o limite de tamanho nos dados temporários do CodeLens e continuar a indexação independentemente do tamanho dos 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"

Você pode usar o comando de coleção para anexar, desanexar ou excluir uma coleção de projetos de uma implantação do 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 uma coleção.

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

Pré-requisitos

Para usar o comando coleções , você deve ser um membro do grupo de segurança Administradores do Team Foundation, bem como o grupo de 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 do SQL Server usadas pelos bancos de dados do Azure DevOps Server. Se sua implantação estiver integrada ao SharePoint e você estiver usando a opção /delete, você também deverá ser membro do grupo Administradores da Fazenda para a fazenda do SharePoint de onde está excluindo o conjunto de sites.

Para obter mais informações, consulte a referência de permissão para o Servidor do Azure DevOps.

Observações

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 do Servidor do Azure DevOps.

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 Contoso Summer Interns Projects coleção de projetos, nomeá-la Contoso Winter Interns Projectse anexar a coleção duplicada à implantação do Azure DevOps Server.

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

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

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

Pré-requisitos

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

Observações

Normalmente, você usaria o comando columnStoreIndex se estivesse movendo um banco de dados de uma instância do SQL com suporte para um í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 que suporta índice de armazenamento em coluna, talvez você queira reativar o índice de armazenamento em coluna para economizar espaço e melhorar o desempenho.

Exemplo

O exemplo a seguir mostra como habilitar o índice de armazenamento de colunas para um banco de dados nomeado TFS_DefaultCollection em uma instância SQL que está em execução em um servidor nomeado ContosoMain na instância nomeada TeamDatabases.

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

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 Servidor do Azure DevOps.

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

Pré-requisitos

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

Observações

Normalmente, você usaria o comando dbCompression se estivesse movendo um banco de dados de uma instância sql com suporte de compactação 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 SQL com suporte de compactação, talvez você queira reativar a compactação para economizar espaço.

Esse comando só muda se o 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 do SQL cuja edição dá suporte à compactação. Consulte os recursos compatíveis com as edições do SQL Server para obter mais informações.

Exemplo

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

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

Use o comando deleteTestResults para excluir resultados de teste armazenados antigos do repositório de coleção. 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]

Pré-requisitos

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

Observações

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 nomeado TFS_DefaultCollection em uma instância SQL em execução em um servidor nomeado ContosoMain na instância TeamDatabasesnomeada.

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

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>

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

• Alterando o domínio de sua 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

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

Pré-requisitos

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

Observações

Opcionalmente, você pode especificar o banco de dados para alterar identidades antes de configurar um servidor de 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 do Azure DevOps Server.

Quando você altera identidades, a conta de destino ou contas já deve 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 no 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 no 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 para todas as contas no Servidor do Azure DevOps 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 para 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\hholtpara 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 que é usada na implantação do Servidor do Azure DevOps 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, você altera a conta de serviço de NT AUTHORITY\NETWORK SERVICE para uma conta de domínio no novo domínio TempSVC, e então altera 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"

Você pode usar o comando trabalhos 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 tentar novamente um trabalho para uma ou todas as coleções de projetos.

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

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 a referência de permissão para o Servidor do Azure DevOps.

Observações

Para tentar um trabalho de forma interativa, você pode abrir o console de administração do Azure DevOps, selecionar a guia Status da coleção e selecionar Retry Job. 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 Contoso Summer Intern Projects coleção de projetos no Azure DevOps Server.

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

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>

Pré-requisitos

Para usar o comando offlineDetach :

• Você deve ser um membro da função sysadmin para a instância do SQL Server especificada.
• A versão da ferramenta TFSConfig deve corresponder à versão do banco de dados do Servidor do Azure DevOps.

Observações

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 Servidor do Azure DevOps. Se os bancos de dados estiverem em uso por uma implantação do Servidor do Azure DevOps, 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 da mesma implantação do Servidor do Azure DevOps. 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, configurando uma implantação do Servidor do Azure DevOps usando esses bancos de dados e desanexando a única 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 interesse da coleção e executar o comando offlineDetach . Em seguida, o banco de dados de coleção desvinculado pode ser vinculado a qualquer implantação do 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 nomeado ContosoTemp na instância Backupsnomeada.

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

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 ampla área. 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, quaisquer trocas de metadados e uploads de arquivo continuam a aparecer no Servidor do Azure DevOps. 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,

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

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 a referência de permissão para o Servidor do Azure DevOps.

Observações

Use o comando proxy para atualizar a configuração existente do Proxy do Servidor do Azure DevOps. Você não pode usar o comando proxy para instalação inicial e configuração do proxy.

Exemplos

O exemplo a seguir mostra como adicionar uma implantação do Servidor do Azure DevOps nomeada 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 no Azure DevOps Services à lista de proxy usando um Token de Acesso Pessoal para autenticação. Esse token será usado apenas para registrar o proxy com a conta do Azure DevOps Services – a conta de serviço padrão ainda será usada para executar o proxy. Esse parâmetro foi adicionado ao TFS 2018 Update 1 para dar suporte ao registro de um Proxy no 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 parâmetro /Collection. 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 é nomeada PhoneSaver, o nome da conta usada para o 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 elas.

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

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

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

Pré-requisitos

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

• O grupo de segurança Administradores do Azure DevOps e o grupo de segurança Administradores nos 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 do SQL Server que hospeda os bancos de dados do Azure DevOps Server

Para obter mais informações, consulte a referência de permissão para o Servidor do Azure DevOps.

Observações

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

Para iniciar a recompilação desses bancos de dados interativamente, você pode usar o nó Reporting 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 do Servidor do Azure DevOps.

TfsConfig rebuildWarehouse /analysisServices

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

Use registerDB para atualizar o nome do servidor que hospeda o banco de dados de configuração no Servidor do Azure DevOps. 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>

Pré-requisitos

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

Observações

Faça backup dos bancos de dados do Servidor do Azure DevOps antes de usar esse comando.

Para que o comando registerDB seja bem-sucedido, os seguintes pools de aplicativos e programas devem estar em execução:

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

Você deve fornecer o nome ou o 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 o Servidor do Azure DevOps aponta para o novo local.

Exemplo

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

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

O comando remapDBs redireciona o Servidor do Azure DevOps para seus bancos de dados quando eles são armazenados em mais de um servidor e você está restaurando, movendo ou alterando de outra forma a configuração de sua implantação. Por exemplo, você deve redirecionar o Servidor do Azure DevOps para quaisquer bancos de dados para coleções de projetos se eles estiverem hospedados em um servidor ou servidores separados do banco de dados de configuração. Você também deve redirecionar o Azure DevOps Server para o servidor ou servidores que estão executando o SQL Server Analysis Services ou o 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]

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 quaisquer bancos de dados do SQL Server que o Azure DevOps Server usa. Para obter mais informações, consulte a referência de permissão para o Servidor do Azure DevOps.

Observações

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

Exemplo

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

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

Use o comando repairJobQueue para corrigir trabalhos agendados que pararam de ser executados nos servidores responsáveis pela implantação e coleta.

TfsConfig repairJobQueue

Pré-requisitos

Para usar o comando repairJobQueue , você deve ser um membro do grupo de 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 do SQL Server usadas pela implantação do Azure DevOps Server.

Observações

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 exige que a implantação do Servidor do Azure DevOps seja configurada.

Exemplo

TfsConfig repairJobQueue

Você pode usar o comando configurações para automatizar as alterações na URL (uniform resource locator) que é usada pela interface de notificação e para o endereço do servidor do Azure DevOps Server. Por padrão, a URL da interface de notificação e a URL do servidor correspondem no Servidor do Azure DevOps, mas você pode configurar URLs separadas. Por exemplo, talvez você queira usar uma URL diferente para os emails automáticos gerados pelo 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 exibir as configurações atuais, você pode usar o console de administração do Azure DevOps. Consulte a referência rápida de tarefas administrativas.

TfsConfig settings [/publicURL:URL]

Pré-requisitos

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

Observações

O comando de configurações altera as informações de conexão para comunicação servidor a servidor em uma implantação do Servidor do Azure DevOps. A URL especificada em /publicURL deve estar disponível para todos os servidores na implantação.

Exemplo

O exemplo a seguir altera o valor de NotificationURL 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

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 tipos de item de trabalho (WITs).

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

Pré-requisitos

Você deve ser um membro do grupo de segurança Team Foundation Administrators e um administrador do servidor da camada de aplicação.

Consulte Definir permissões de administrador para o Servidor do Azure DevOps.

Observações

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 usar o comando TCM, primeiro você deve importar a definição do item de trabalho do plano de teste e a categoria de plano de teste para o projeto.

Para saber mais sobre a migração e quando usar esse comando, consulte 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 do 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 o 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 verificar o status da 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"

Disponibilidade do comando: Azure DevOps Server 2019

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

Por exemplo, se você usar o Azure DevOps Build, poderá utilizar o comando unattend para instalar múltiplos servidores de construção com o mesmo arquivo de configuração.

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

Esse processo permite que você configure o Servidor do Azure DevOps do início ao fim sem precisar fornecer entrada durante o processo de instalação. No caso de várias instalações, isso também ajuda 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]

Pré-requisitos

• Você deve ser membro do grupo Administradores no computador em que está instalando o software.

• Dependendo do tipo de instalação, você também pode exigir permissões de administrador adicionais.

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

Observações

Antes de conseguir usar o comando unattend para configurar o Azure DevOps Server, você deve criar as contas de serviço que utilizará na sua implantação. Você também deve instalar qualquer software de pré-requisito para o tipo de instalação escolhido. Isso inclui o próprio Servidor de DevOps do Azure. Você deve instalar o Azure DevOps Server, mas não precisa configurá-lo porque o comando unattend fará isso por você.

O comando unattend configura os componentes do Azure DevOps Server. Ele não executa a instalação inicial do software. Ele configura o software de acordo com suas especificações depois que os bits estão presentes no computador.

Exemplos

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

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

Neste exemplo, o arquivo unattend é criado no mesmo diretório que o 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 de instalação autônoma para a configuração de um Azure DevOps Proxy Server.

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 unattend para a configuração do Build do Azure DevOps Server em um servidor usando FabrikamFiber\BuildSVC como a conta de serviço de build e, em seguida, configurar o Build do Azure DevOps Server usando esse arquivo unattend.

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

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

ZipLogs de TfsConfig

TfsConfig zipLogs