Comando Status (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), status ou seu alias , exibe informações sobre alterações pendentes statem arquivos e pastas e candidatos a alterações pendentes em um ou mais espaços de trabalho. Quando você usa a /shelveset opção, o comando exibe informações sobre alterações pendentes em um conjunto de prateleiras.

Nota

Um candidato a alteração pendente é um arquivo na pasta ou subpasta do espaço de trabalho que não é adicionado ao controle de versão. Para exibir todos os candidatos a alterações pendentes no Visual Studio, vá para Alterações>Pendentes Alterações Excluídas do Team Explorer>e selecione Detetado.

Pré-requisitos

Para usar o status comando, você deve ter a permissão de Leitura para o item de origem e as permissões de Check-out e Mesclagem para a pasta de destino definidas como Permitir. Para obter mais informações, consulte Permissões TFVC padrão.

Sintaxe

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

Parâmetros

Argumentos

Argumento

Descrição

/collection: <TeamProjectCollectionUrl>

Quando você usa a /workspace opção, especifica a URL da coleção de projetos que contém o espaço de trabalho que contém as alterações pendentes. Por exemplo: http://myserver:8080/tfs/DefaultCollection.

Se não for especificado, por padrão, presume-se que a coleção de projetos seja aquela que contém o espaço de trabalho que mapeia o diretório atual.

Ignorado se você não usar a /workspace opção.

Nota

Consulte Observações para conhecer as limitações desta opção.

/format

Especifica a quantidade de detalhes a serem exibidos sobre cada alteração pendente:

  • Brief (padrão): Exibe uma linha sobre cada alteração pendente que inclui: nome do arquivo, alterações, se o item está bloqueado conforme indicado por um asterisco *, caminho local e usuário se estiver usando as /collection opções e /workspace . Alguns dos dados podem estar truncados.
  • Detailed: Exibe uma descrição completa de cada alteração pendente. Além das informações acima, essa opção exibe mais dados, como data e hora.

<itemspec>

Especifica os itens para os quais você deseja dados de alteração pendentes. Para obter sintaxe, consulte Usar comandos de controle de versão do Team Foundation. Você pode especificar mais de um itemspec argumento.

/login

Especifica a conta de usuário a ser usada para executar o comando. Consulte Usar comandos de controle de versão do Team Foundation.

/recursive

Recursivamente recupera dados sobre alterações pendentes em itens no diretório especificado e quaisquer subdiretórios.

/shelveset:<shelvesetname>[;<shelvesetowner>]

Especifica o conjunto de prateleiras que contém as alterações que você deseja listar.

Esta opção não pode ser combinada com a /workspace opção.

/user

Lista todas as alterações pendentes feitas pelo usuário especificado. Um asterisco * inclui dados sobre alterações de todos os usuários. A predefinição é o utilizador atual.

Valores aceitáveis para esta opção:

  • <username>
  • <useraccount>
  • Asterisco *

Nota

Consulte Observações para conhecer as limitações desta opção.

/workspace:<workspacename>[;<workspaceowner>]

Especifica o nome do espaço de trabalho que contém as alterações pendentes. Se não for especificado, o espaço de trabalho é aquele que mapeia o diretório atual.

Você pode especificar workspaceowner para obter dados sobre alterações pendentes em um espaço de trabalho que pertence a um usuário específico. Se não for especificado, presume-se que o espaço de trabalho seja o usuário atual ou, se especificado, o /login:<username>.

Esta opção não pode ser combinada com a /shelveset opção.

Nota

Consulte Observações para conhecer as limitações desta opção.

Observações

Você pode usar o status comando para exibir alterações pendentes no espaço de trabalho atual, por exemplo, o espaço de trabalho que mapeia o diretório atual, independentemente de ser um espaço de trabalho local ou um espaço de trabalho de servidor. Você também pode usar esse comando para exibir alterações pendentes em um espaço de trabalho de servidor remoto, por exemplo, alterações feitas por outro usuário em outra máquina de desenvolvimento, usando as /collectionopções , /usere /workspace . No entanto, não é possível visualizar as alterações pendentes em um espaço de trabalho local remoto.

Para obter mais informações, consulte Decidir entre usar um espaço de trabalho local ou de servidor.

Exemplos

Em todos os exemplos a seguir, suponha que $/SiteApp/Main/ está mapeado para c:\code\SiteApp\Main\ no espaço de trabalho.

Listar todas as alterações no espaço de trabalho atual

O exemplo a seguir lista todas as alterações pendentes no espaço de trabalho:

c:\code\SiteApp\Main\SolutionA\>tf stat

Listar todas as alterações em uma pasta

O exemplo a seguir lista todas as alterações pendentes em todos os itens na pasta SolutionA :

c:\code\SiteApp\Main>tf stat SolutionA\*

Listar todas as alterações em uma pasta e suas subpastas

O exemplo a seguir lista as alterações pendentes em todos os itens na pasta SolutionA , incluindo as alterações em suas subpastas:

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

Próximos passos