Usar o TFSConfig para gerir o Azure DevOps no local

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

• a conta de serviço do Azure DevOps Server
• as fontes de dados contemplam o SQL Server Reporting Services
• a conta de serviço do Azure DevOps Proxy Server

Você também pode usar esse comando para alterar a propriedade dos bancos de dados do Servidor de DevOps do Azure.

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 desastres em que outra conta é necessária antes de executar o assistente de configuração Somente AT.

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

Pré-requisitos

Para usar o comando accounts, deves 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 a 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 Referência de permissão para o Azure DevOps Server.

Observações

Use o comando accounts para automatizar as alterações nas contas de serviço, bancos de dados e grupos de contas de serviço do Servidor de DevOps do Azure. 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 possuir a permissão A conta é sensível e não pode ser delegada no servidor de camada de aplicação. Para obter mais informações, consulte esta página no site da Microsoft: Habilitando a autenticação delegada.

O comando contas suporta implantações locais do Azure DevOps Server. Para alterar o proprietário da conta de uma conta dos Serviços de DevOps do Azure, 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, Contoso\NewAccount, e altere a senha para Password.

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

Adicione a conta do sistema do Serviço de Rede aos grupos de contas de serviço do 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 dados TFS_Warehouse no ContosoMain SQL Server 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, deves ter permissões para executar TFSConfig e para carregar relatórios no Reporting Service.

Observações

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

Pode ser necessário usar este comando quando:

• O projeto foi criado no portal do Azure DevOps e não do 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 atualizou o Servidor de DevOps do Azure 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 de DevOps do Azure local, consulte Adicionar relatórios a um projeto.

Exemplo

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

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

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

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

Pré-requisitos

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

Observações

O comando Authentication é 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 a partir da camada de aplicativo para atualizar os sites que exigem uma alteração em seu protocolo de autenticação de rede. O comando altera a propriedade NTAuthenticationProviders na metabase do IIS.

Antes de usar o comando Authentication para alterar o protocolo de autenticação, você pode executá-lo 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 certificates para alterar como os certificados são configurados para autenticação de cliente em uma implantação do Azure DevOps Server 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, deve ser membro do grupo de segurança dos Administradores do Azure DevOps e do grupo local de Administradores no computador a partir do qual executa o comando. Para obter mais informações, consulte Referência de permissão para o Azure DevOps Server.

Observações

Por padrão, o comando certificates selecionará automaticamente um certificado de 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 da máquina local.

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

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

Exemplos

O exemplo a seguir mostra como especificar o certificado de máquina 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 de cliente do repositório de usuário atual.

TfsConfig certificates /autoselect

O comando changeServerID altera os GUIDs associados aos bancos de dados do Azure DevOps Server. Os GUIDs devem ser exclusivos dentro de uma implantação do Servidor de DevOps do Azure. 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 de todos os bancos de dados de coleção de projetos na implantação ou ambos.

Embora normalmente não use esse comando em operações diárias, você pode usá-lo 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. Esse cenário às vezes é 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 para novo hardware em um laboratório de teste ou 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 esse GUID já está reservado.

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

Pré-requisitos

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

Observações

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

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

Use o comando codeIndex para gerenciar a indexação de código no Azure DevOps Server. Por exemplo, talvez você queira redefinir o índice para corrigir as 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 de DevOps do Azure. Consulte Referência de permissão para o Azure DevOps Server.

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

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

Para encontrar até 50 ficheiros com mais de 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 ficheiros 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 guardar todo o histórico do conjunto de alterações:

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 collection 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 collection para duplicar o banco de dados de uma coleção existente, renomeá-la e anexá-la à implantação. Esse processo às vezes é 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 membro do grupo de segurança Administradores do Team Foundation, assim como do grupo Administradores locais na máquina que executa 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 a sua implantação estiver integrada ao SharePoint e estiver a usar a opção /delete, também deverá ser membro do grupo Administradores de Farm de servidores do SharePoint dos quais está a excluir o conjunto de sites.

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

Observações

Para gerenciar coleções interativamente ou para 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 coleção de projetos Contoso Summer Intern Projects de uma implantação do 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 projetos Contoso Summer Interns Projects, 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 Servidor de DevOps do Azure.

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

Pré-requisitos

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

Observações

Normalmente, você usaria o comando columnStoreIndex se estivesse movendo um banco de dados de uma instância SQL que suportasse o índice de armazenamento de colunas para uma que não suportasse. Nesse caso, você precisaria desabilitar todos os índices de armazenamento 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 suportasse o índice de armazenamento de colunas, talvez desejasse reativar o índice de armazenamento de colunas para economizar espaço e ganhar desempenho.

Exemplo

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

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

Use o comando dbCompression para ativar ou desativar a compressão de paginação de banco de dados para os bancos de dados utilizados pela implementação do Azure DevOps Server.

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

Pré-requisitos

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

Observações

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

Este comando só muda se o Azure DevOps Server prefere usar a compactação de página de banco de dados ou não - seus bancos de dados ainda devem ser hospedados em uma instância SQL cuja edição ofereça suporte à compactação. Consulte funcionalidades suportadas pelas 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 chamado TFS_DefaultCollection em uma instância SQL em execução em um servidor chamado 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 seu repositório de coleção. Isso geralmente é feito para reduzir o tamanho da loja ou para reduzir o tempo necessário 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 membro da função sysadmin para a instância especificada do SQL Server.

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 de teste manuais 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 nomeada TeamDatabases.

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 identidades lista ou altera o identificador de segurança (SID) de usuários e grupos em sua implantação do Servidor de DevOps do Azure. 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

• Mudar 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 Ative Directory

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

Pré-requisitos

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

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 ou contas de destino já devem existir no Windows.

Você deve aguardar a próxima sincronização de identidade com o Windows antes que as propriedades das contas que você alterar com esse comando sejam atualizadas. Este requisito inclui alterações de grupo para utilizador, de utilizador para grupo e de 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 Servidor de DevOps do Azure e exibir se o SID de cada usuário ou grupo corresponde ao SID no Windows. Os administradores de domínio da Contoso1 criaram grupos de domínio como Contoso1\\Developers e Contoso1\\Testers para ajudar a facilitar o gerenciamento de permissões no Servidor de DevOps do Azure, no SQL Server Reporting Services e nos 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 de DevOps do Azure do domínio Contoso1 para os SIDs para contas que têm nomes correspondentes no domínio ContosoPrime. Apenas os nomes de conta que corresponderem terão seus SIDs atualizados. Por exemplo, se a conta hholt existir como Contoso1\hholt e ContosoPrime\hholt, o SID da conta será alterado para o SID para ContosoPrime\hholt. Se a conta ContosoPrime\hholt 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 serviço NT AUTHORITY\NETWORK SERVICE usada na implantação do Azure DevOps Server ao alterar o domínio da implantação de Contoso1 para ContosoPrime. Para alterar uma conta do sistema, como 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 SERVIÇO DE REDE no servidor no novo domínio. O banco de dados de configuração é hospedado no servidor chamado ContosoMain na instância nomeada TeamDatabases 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 jobs para criar um arquivo de log que forneça os detalhes da atividade de trabalho mais recente para uma coleção de projeto específica ou para tentar novamente um trabalho para uma ou todas as coleções de projeto.

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

Pré-requisitos

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

Observações

Para repetir uma tarefa interativamente, pode abrir a consola de administração do Azure DevOps, selecionar o separador Estado da coleção e, em seguida, selecionar Repetir Tarefa. 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 projetos Contoso Summer Intern Projects 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 membro da função sysadmin para a instância especificada do SQL Server.
• A versão da ferramenta TFSConfig deve corresponder à versão do banco de dados do Azure DevOps Server.

Observações

Este 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 Azure DevOps Server. Se seus bancos de dados estiverem em uso por uma implantação do Azure DevOps 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 da mesma implantação do Azure DevOps Server. Anteriormente, isso exigia restaurar um conjunto completo e consistente de bancos de dados (configuração e todas as coleções) em um ambiente de preparação, configurar uma implantação do Azure DevOps Server usando esses bancos de dados e desanexar a única coleção de interesse.

Em vez disso, agora você pode restaurar cópias consistentes do banco de dados de configuração e do banco de dados de coleta de interesse e executar o comando offlineDetach. O banco de dados de coleção desanexado pode ser anexado a qualquer implementação do Azure DevOps Server na 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 nomeada Backups.

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 Azure DevOps Proxy Server. O Azure DevOps Proxy Server 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 carregamentos de arquivos continuam a aparecer no Azure DevOps Server. Se você usar os Serviços de DevOps do Azure para hospedar seu projeto de desenvolvimento na nuvem, poderá usar o comando Proxy não apenas para gerenciar o cache de 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 Azure DevOps Proxy Server e a configuração inicial do proxy,

consulte Como instalar o Azure DevOps Proxy Server e configurar um site remoto. Para obter mais informações sobre como configurar o proxy em computadores cliente, consulte Referência de Comando do 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 membro do grupo de segurança Administradores de DevOps do Azure e administrador no servidor proxy. Para obter mais informações, consulte Referência de permissão para o Azure DevOps Server.

Observações

Use o comando proxy para atualizar a configuração existente do Proxy do Servidor de DevOps do Azure. 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 do 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 nos Serviços de DevOps do Azure à lista de proxy usando um Token de Acesso Pessoal para autenticar. 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. Este parâmetro foi adicionado na Atualização 1 do TFS 2018 para dar suporte ao registro de um Proxy com os Serviços de DevOps do Azure sem exigir 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 a 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 nos Serviços de DevOps do Azure. A coleção tem o nome PhoneSaver, o nome da conta usada para os Serviços de DevOps do Azure é 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 incluir o nome.

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 GVFS.

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

Você pode usar o comando rebuildWarehouse para recriar os bancos de dados do SQL Server Reporting Services e do SQL Server Analysis Services usados pelo Azure DevOps Server.

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

Pré-requisitos

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

• O grupo de segurança Administradores de DevOps do Azure e o grupo de segurança Administradores no servidor ou servidores que executam 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 para o Azure DevOps Server

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

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 reconstrução desses bancos de dados interativamente, você pode usar o nó Relatórios 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 recriar o banco de dados do Analysis Services para uma implantação do 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.

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>

Pré-requisitos

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

Observações

Faça backup dos bancos de dados do Servidor de DevOps do Azure 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 Azure DevOps Server (pool de aplicativos)
• ReportServer (pool de aplicativos)
• SQL Server Reporting Services (programa)

Você deve fornecer o nome exato ou o endereço do banco de dados de configuração para que esse comando funcione corretamente. Se você precisar alterar o servidor no qual esse banco de dados está armazenado, deverá garantir que o Servidor de DevOps do Azure aponte 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 do SQL Server TeamDatabases.

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

O comando remapDBs redireciona o 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 de sua implantação. Por exemplo, você deve redirecionar o Servidor de DevOps do Azure 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 Servidor de DevOps do Azure 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 separada do banco de dados de configuração.

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

Pré-requisitos

Para utilizar o comando remapDBs, deve ser membro do grupo de segurança Administradores do Azure DevOps e membro do grupo de segurança sysadmin para os bancos de dados do SQL Server que são utilizados pelo Azure DevOps Server. Para obter mais informações, consulte Referência de permissão para o Azure DevOps Server.

Observações

Use o comando remapDBs para reconfigurar o Azure DevOps Server de modo a utilizar diferentes servidores e instâncias do SQL Server em relação aos servidores e instâncias da instalação original.

Exemplo

O exemplo a seguir mostra como redirecionar o Azure DevOps Server para seu banco de dados de configuração TFS_Configuration. Esse banco de dados é hospedado em ContosoMain na instância nomeada TeamDatabases. Os bancos de dados da coleção de projetos estão armazenados tanto no ContosoMain\TeamDatabases quanto na instância padrão no Contoso2.

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

Utilize o comando repairJobQueue para corrigir trabalhos agendados que deixaram de funcionar em hosts de implantação e de coleta.

TfsConfig repairJobQueue

Pré-requisitos

Para usar o comando repairJobQueue, você deve ser membro do grupo de administradores locais na máquina que executa 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 notar que algum trabalho agendado não está em execução.
O comando não usa argumentos e requer que a implantação do Servidor de DevOps do Azure seja configurada.

Exemplo

TfsConfig repairJobQueue

Você pode usar o comando de configurações para automatizar as alterações na URL (uniform resource locator) usada pela interface de notificação e para o endereço do servidor Azure DevOps Server. Por padrão, a URL da interface de notificação e a URL do servidor correspondem no Servidor de DevOps do Azure, 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 a partir da 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 tarefa administrativa .

TfsConfig settings [/publicURL:URL]

Pré-requisitos

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

Observações

O comando configurações altera as informações de conexão para comunicação entre servidores em uma implantação do 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

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

Se a migração automática falhar, use o comando TCM para atualizar seus planos de teste e conjuntos de testes manualmente para seus respetivos 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 Administradores do Team Foundation e um administrador no servidor de camada de aplicação.

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

Observações

Seu servidor de 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, você deve 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, 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, você terá que executá-lo em relação a cada projeto individualmente.

Você deve executar o comando TCM a partir do diretório de ferramentas do Azure DevOps Server. Por predefinição, esse local é: drive:\%programfiles%\TFS 12.0\Tools.

Você usa o comando TCM somente no caso de falha na migração automática de dados de teste existentes.

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, você terá que executá-lo em cada projeto por 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 desatendido foi projetado para utilizadores que estão familiarizados com o Azure DevOps Server e o processo de configuração, e que precisam instalar o Azure DevOps Server em diferentes máquinas.

Por exemplo, se você usar o Azure DevOps Build, poderá usar o comando unattend para instalar vários servidores de compilação usando o mesmo arquivo de configuração.

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

Esse processo permite que você configure o Servidor de 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 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

• Tem de ser membro do grupo Administradores no computador onde está a instalar o software.

• Dependendo do tipo de instalação, você também pode precisar de 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 Perguntas & A de Adicionar administradores de nível de servidor ao Azure DevOps Server.

Observações

Antes de poder usar o comando unattend para configurar o servidor do Azure DevOps, deve criar as contas de serviços que utilizará como parte da implementaçã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 não assistido 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 autônomo para uma instalação básica do Azure DevOps Server.

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

Neste exemplo, o ficheiro unattend é criado na mesma pasta 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 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 de DevOps do Azure.

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

O exemplo a seguir mostra como criar um ficheiro de resposta não assistida para a configuração do Azure DevOps Server Build num servidor usando FabrikamFiber\BuildSVC como a conta de serviço de Build e, em seguida, configurar o Azure DevOps Server Build usando esse ficheiro de resposta não assistida.

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 onde o Azure DevOps Build 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 deixa um zip em ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs