Comando Status (Controle de Versão do Team Foundation)
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/collectione/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
A maioria das alterações feitas em arquivos sob controle de versão são enfileiradas como alterações pendentes em seu workspace. Para obter mais informações, consulte Desenvolver código e gerenciar alterações pendentes e Criar e trabalhar com workspaces.
Você pode usar o comando Difference para obter detalhes sobre alterações de edição ou alterações no conteúdo em um arquivo.
Se você precisar deixar de lado as alterações ou quiser limpar seu workspace para outra tarefa, use o Comando Shelve. Para obter mais informações sobre conjuntos de check-in particular, consulte Suspender seu trabalho e gerenciar seus check-ins particulares.
Quando estiver pronto para fazer check-in de alterações no servidor, use o comando Checkin.
Para obter mais informações sobre como usar o utilitário
tf, consulte Usar comandos de controle de versão do Team Foundation