Comando de coleção

Artigo
02/26/2013

Você pode usar o comando de Collection anexar, desanexe, ou excluir uma coleção de projeto de equipe de uma implantação de Visual Studio Team Foundation Server (TFS).Você também pode usar o comando de Collection duplicar o banco de dados de uma coleção existente, renomeá-lo, e anexá-la a implantação.Esse processo é às vezes referido como clonar uma coleção.Em o entanto, você não pode usar o comando de Collection criar uma coleção de projeto de equipe.Para mais informações, consulte Criar uma coleção de projeto de equipe.

Coleções para gerenciar interativamente ou criar uma coleção, você pode usar o nó de Coleções de projeto de equipe no console de administração do Team Foundation.Para obter mais informações, consulte Abra o Console de administração do Team Foundation e Organizando seu servidor com coleções de projeto de equipe.

Permissões Necessárias

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

o grupo de segurança Administradores do team foundation e o grupo de segurança Administradores no servidor ou em servidores que estão executando o console de administração do Team Foundation
o grupo de sysadmin no servidor ou servidores que estão executando a instância de SQL Server que hospeda os bancos de dados para Team Foundation Server
o grupo de administradores de farm para o farm de que você está apagando a coleção do site, se sua implantação e usa Produtos do SharePoint você estiver usando a opção de /delete .

Para obter mais informações, consulte Team Foundation Permissões do servidor.

Observação
Mesmo se você fizer logon com credenciais administrativas, você deve abrir uma janela de prompt de comando alto para executar esta função.

TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]

Parâmetros

o espaço reservado	Descrição
CollectionName	Especifica o nome da coleção de projeto de equipe.Se o nome da coleção contém espaços, você deve incluir o nome entre aspas (por exemplo, “my coleção”).
ServerName	Especifica o nome do servidor que hospeda o banco de dados de configuração para TFS, e o nome da instância se você desejar usar uma instância diferente da instância padrão.Se você especificar uma instância de, você deve usar o seguinte formato: ServerName\InstanceName
DatabaseName	Especifica o nome do banco de dados de configuração.Por padrão, o nome do banco de dados é TFS_ConfigurationDB.

CollectionName

Especifica o nome da coleção de projeto de equipe.Se o nome da coleção contém espaços, você deve incluir o nome entre aspas (por exemplo, “my coleção”).

ServerName

Especifica o nome do servidor que hospeda o banco de dados de configuração para TFS, e o nome da instância se você desejar usar uma instância diferente da instância padrão.Se você especificar uma instância de, você deve usar o seguinte formato:

ServerName\InstanceName

DatabaseName

Especifica o nome do banco de dados de configuração.Por padrão, o nome do banco de dados é TFS_ConfigurationDB.

Opção	Descrição
/attach	Necessário se nem nem /detach/delete são usados.Se você especificar esta opção, você também deve usar a opção de /collectionDB .Como uma opção, você também pode usar /collectionName e /clone com essa opção.Se você usar a opção de /attach , o banco de dados especificado da coleção será adicionada à implantação de TFS.
/detach	Necessário se nem nem /attach/delete são usados.Se você especificar esta opção, você também deve usar a opção de /collectionName .Se você usar a opção de /detach , o banco de dados para a coleção especificada será interrompido, e a coleção será desanexada da implantação de TFS.
/delete	Necessário se nem nem /detach/attach são usados.Se você especificar esta opção, você também deve usar a opção de /collectionName .Se você usar a opção de /delete , o banco de dados para a coleção especificada será interrompido, e a coleção será desanexada permanentemente de TFS.Você não poderá reatar o banco de dados de coleção para este ou a nenhuma outra implantação.
/CollectionName:CollectionName	Necessário se /detach ou /delete são usados.Se você usar esta opção com /detach ou /delete, especifica uma coleção que será desanexada ou excluída.Se você usar esta opção com /attach, especifica um novo nome para a coleção.Se você usar esta opção com ambos /attach e /clone, especifica o nome para a coleção duplicada.
/CollectionDB:ServerName;DatabaseName	Necessário se /attach for usado.Esta opção especifica o nome do servidor que está executando SQL Server e o nome do banco de dados de coleção que é hospedado no servidor.
/clone	Se você especificar esta opção, o banco de dados original da coleção como um clone será anexado em SQL Server, e esse banco de dados será anexado a TFS.Essa opção é usado principalmente como parte de dividir uma coleção de projeto de equipe.

Exemplo

O exemplo a seguir mostra como remover permanentemente de “a coleção de projeto de equipe projetos de interno de verão Contoso” de uma implantação de Team Foundation Server.

Observação
Os exemplos são para a ilustração somente e são fictícios.Nenhuma associação real é destinada ou inferido.

TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"

O exemplo a seguir mostra como “duplicar da coleção de projeto de equipe projetos de internos de verão Contoso”, nomeá-la de inverno “Contoso interna projetos,” e anexa a coleção duplicado a implantação de Team Foundation Server.

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

Consulte também

Compartilhar via

Comando de coleção

Parâmetros

Exemplo

Consulte também

Tarefas

Conceitos

Outros recursos

Recursos adicionais