Compartilhar via

Comando Shelvesets (Controle de Versão do Team Foundation)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2019 | Visual Studio 2022

O comando TFVC (Controle de Versão do Team Foundation) shelvesets exibe informações sobre um conjunto de alterações arquivadas.

Pré-requisitos

Categoria Requirements
Permissões Permissão de leitura e a permissão de check-out definida para Permitir os itens nos conjuntos de prateleiras.

Para obter mais informações, consulte permissões TFVC padrão.

Sintaxe

tf shelvesets [/owner:ownername] [/format:(brief|detailed)] [/collection:TeamProjectCollectionUrl]] [/login:username,[password]] shelvesetname

Parâmetros

Argumentos

de argumento descrição
<ownername> Fornece um valor como * ou DOMAIN\username à opção /owner.
<shelvesetname> O nome do conjunto de prateleiras.
<TeamProjectCollectionUrl> A URL da coleção de projetos que contém um conjunto de alterações arquivadas sobre as quais você deseja exibir informações, por exemplo, http://myserver:8080/tfs/DefaultCollection.
<username> Fornece um valor para a opção /login. Você pode especificar um valor de nome de usuário como DOMAIN\username ou username.

Opções

opção descrição
/owner Especifica um ou mais proprietários de conjunto de prateleiras. Você pode usar caracteres curinga.
/format Especifica em que tipo de formato exibir informações do conjunto de prateleiras.

Brief exibe o nome do conjunto de prateleiras, o nome do usuário que o criou e um comentário de conjunto de prateleiras, se houver. Detailed exibe o nome do conjunto de prateleiras, o proprietário e o comentário, além de uma lista de itens de trabalho associados e quaisquer anotações de check-in. Brief é o valor padrão.
/collection Especifica a coleção de projetos.
/login Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.

Observações

Os conjuntos de prateleiras são criados pelo comando Shelve. Os conjuntos de prateleiras são armazenados no servidor do Azure DevOps e podem ser recuperados em um workspace por qualquer usuário que tenha permissões suficientes usando o comando Unshelve.

Ao contrário de um conjunto de alterações, um conjunto de prateleiras é uma entidade sem versão. Se você ou outro usuário desacompartar os itens em um conjunto de prateleiras, editar vários arquivos e ajudar novamente o conjunto de prateleiras, o TFVC não criará uma nova versão dos itens para comparação futura. O TFVC não mantém nenhum registro de quem revisou os itens, quando ou como. Para obter mais informações sobre como decidir se deseja arquivar ou fazer check-in de um conjunto de alterações pendentes e uma visão geral das prateleiras, consulte Trabalhar com conjuntos de prateleiras.

Para obter informações detalhadas sobre as revisões de arquivo de origem individuais em um conjunto de prateleiras específico, você pode usar o comando Status com a opção /shelveset.

Você pode comparar uma revisão arquivada com sua versão de conjunto de prateleiras base sem desabilvar o item em seu workspace. Você pode usar esse recurso para realizar uma rápida revisão de código par.

Para obter mais informações sobre como usar o utilitário de linha de comando tf, consulte Usar comandos de controle de versão do Team Foundation.

Exemplos

O exemplo a seguir exibe informações sobre o conjunto de prateleiras BuddyTest_23 para o servidor do Azure DevOps para o qual o diretório atual mapeia:

c:\projects>tf shelvesets BuddyTest_23

O exemplo a seguir lista os conjuntos de prateleiras pertencentes ao Pat:

c:\projects>tf shelvesets /owner:Pat

O exemplo a seguir exibe informações sobre todos os conjuntos de prateleiras no servidor do Azure DevOps para o qual o diretório atual mapeia:

c:\projects>tf shelvesets /owner:*