Partilhar via


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

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | do Visual Studio 2022

O comando Team Foundation Version Control (TFVC) shelvesets exibe informações sobre um conjunto de alterações arquivadas.

Pré-requisitos

Categoria Requerimentos
Permissões Permissão de leitura e a permissão Check-out definida como Permitir para os itens nas prateleiras.

Para obter mais informações, consulte Default TFVC permissions.

Sintaxe

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

Parâmetros

Argumentos

Argumento Descrição
<ownername> Fornece um valor como * ou DOMAIN\username para a 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 shelveset. Você pode usar caracteres curinga.
/format Especifica em que tipo de formato exibir as 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 do conjunto de prateleiras, se existir. Detailed exibe o nome do conjunto de prateleiras, proprietário e comentário, além de uma lista de itens de trabalho associados e quaisquer notas 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.

Comentários

Shelvesets são criados pelo comando Shelve. Os Shelvesets são armazenados no servidor de DevOps do Azure e podem ser recuperados em um espaço de trabalho 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 desarquivar os itens em um conjunto de prateleiras, editar vários arquivos e arquivar o conjunto de prateleiras, o TFVC não criará uma nova versão dos itens para comparação futura. A CVFT 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 prateleiras.

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

Você pode comparar uma revisão engavetada com sua versão de prateleira base sem desarquivar o item em seu espaço de trabalho. Você pode usar esse recurso para conduzir uma rápida revisão de código de pares.

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 Azure DevOps para o qual o diretório atual é mapeado:

c:\projects>tf shelvesets BuddyTest_23

O exemplo a seguir lista as prateleiras de propriedade de Pat:

c:\projects>tf shelvesets /owner:Pat

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

c:\projects>tf shelvesets /owner:*