Comando Status (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 status do TFVC (Controle de Versão do Team Foundation) ou seu alias stat exibe informações sobre alterações pendentes em arquivos e pastas e candidatos à alteração pendente em um ou mais workspaces. Quando você usa a opção /shelveset, o comando exibe informações sobre alterações pendentes em um conjunto check-in particular.

Observação

Um candidato à alteração pendente é um arquivo na pasta ou subpasta do workspace que não é adicionado ao controle de versão. Para exibir todas as alterações pendentes e candidatas no Visual Studio, acesse Team Explorer>Alterações Pendentes>de Alterações Excluídas e então selecione Detectado.

Pré-requisitos

Para usar o comando status, você deve ter a permissão deLeitura para o item de origem e as permissões Check-out e Mesclagem para a pasta de destino definida como Permitir. Para saber mais, confira Permissões padrão do TFVC.

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

Argument

Descrição

/collection: <TeamProjectCollectionUrl>

Quando você usa a opção /workspace, especifica-se a URL da coleção de projetos que contém o workspace 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 workspace que mapeia o diretório atual.

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

Observação

Consulte Comentários para obter as limitações dessa opção.

/format

Especifica quantos detalhes exibir 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 opções /collection e /workspace. Alguns dos dados podem ser 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 alterar dados pendentes. Para obter sintaxe, consulte Usar comandosde controle de versão do Team Foundation. Você pode especificar mais de um argumento itemspec.

/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

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

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

Especifica o conjunto de check-in particular que contém as alterações que você deseja listar.

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

/user

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

Valores aceitáveis para esta opção:

  • <username>
  • <useraccount>
  • Asterisco *

Observação

Consulte Comentários para obter as limitações dessa opção.

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

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

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

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

Observação

Consulte Comentários para obter as limitações dessa opção.

Comentários

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

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

Exemplos

Em todos os exemplos a seguir, suponha que $/SiteApp/Main/ seja mapeado para c:\code\SiteApp\Main\ no workspace.

Listar todas as alterações no workspace atual

O exemplo a seguir lista todas as alterações pendentes no workspace:

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 para 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 alterações em suas subpastas:

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

Próximas etapas