Partilhar via

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 | do Visual Studio 2022

O comando status do Controle de Versão do Team Foundation (TFVC), ou seu alias stat, exibe informações sobre alterações pendentes em arquivos e pastas e candidatos a alterações pendentes em um ou mais espaços de trabalho. Quando você usa a opção /shelveset, o comando exibe informações sobre alterações pendentes em um conjunto de prateleiras.

Observação

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 Team Explorer>Alterações Pendentes>Alterações Excluídase selecione Detected.

Pré-requisitos

Para usar o comando status, tenha a permissão de leitura para o item de origem e as permissões Check out e Merge para a pasta de destino definidas como Permitir. Para obter mais informações, consulte Default TFVC permissions.

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 opção /workspace, 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 opção /workspace.

Observação

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 opções /collection 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 opção /workspace.

/user

Lista todas as alterações pendentes feitas pelo usuário especificado. Um * de 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>
  • Asterisk *

Observação

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 opção /shelveset.

Observação

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

Comentários

Você pode usar o comando status 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 opções /collection, /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 alterações em suas subpastas:

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

Próximos passos