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

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

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

Pré-requisitos

Para usar o comando shelvesets, você deve ter a permissão Leitura e a permissão deCheck-out definida para Permitir os itens nos check-ins particulares. Para saber mais, confira Permissões padrão do TFVC.

Sintaxe

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

Parâmetros

Argumentos

Argument Descrição
<ownername> Fornece um valor como * ou DOMAIN\username para a opção /owner.
<shelvesetname> O nome do conjunto de check-in particular.
<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> Mostra 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 do conjunto de check-in particular. Você pode usar caracteres curinga.
/format Especifica em que tipo de formato exibir informações do conjunto de check-in particular.

Brief exibe o nome do conjunto de check-in particular, o nome do usuário que o criou e um comentário de conjunto de check-in particular, se houver. Detailed exibe o nome do conjunto de check-in particular, 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 no Azure DevOps.

Comentários

Os check-ins particulares são criados pelo comando Shelve. Os check-ins particulares 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.

Diferente do conjunto de alterações, o check-in particular é uma entidade sem versão. Se você ou outro usuário desfazer o check-in particular em um conjunto de check-in particular, editar vários arquivos e ajudar novamente o conjunto de check-in particular, 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 marcar em um conjunto de alterações pendentes e uma visão geral do check-in particular, consulte Trabalhar com conjuntos de check-in particular.

Para obter informações detalhadas sobre as revisões de arquivo de origem individuais em um conjunto de check-in particular 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 check-in particular base sem desabilitar 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 check-in particular BuddyTest_23 do 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 check-in particular de propriedade de Pat:

c:\projects>tf shelvesets /owner:Pat

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

c:\projects>tf shelvesets /owner:*