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

  • Artigo

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

Visual Studio 2019 | Visual Studio 2022

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

Pré-requisitos

Para usar o shelvesets comando, você deve ter a permissão de leitura e a permissão de check-out definidas como Permitir para os itens nas 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

Argumento Descrição
<ownername> Fornece um valor como * ou DOMAIN\username para a /owner opção.
<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 /login opção. Você pode especificar um valor de nome de usuário como ou DOMAIN\usernameusername.

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.

Observações

Os conjuntos de prateleiras 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 conjuntos de 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 /shelveset opção.

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 tf comando, consulte Usar comandos de controle de versão do Team Foundation.

Exemplos

O exemplo a seguir exibe informações sobre o BuddyTest_23 conjunto de prateleiras para o servidor de DevOps do Azure 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:*