Comando Dir (Controle de Versão do Team Foundation)
Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | do Visual Studio 2022
O comando dir exibe todo ou parte do conteúdo do servidor para Team Foundation Version Control (TFVC).
Pré-requisitos
Para usar o comando dir, tenha permissão Ler definida como Permitir. Para obter mais informações, consulte Default TFVC permissions.
Sintaxe
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parâmetros
Argumentos
Argumento
Descrição
<itemspec>
Identifica o arquivo ou pasta sobre o qual retornar informações. Para obter mais informações sobre como o TFVC analisa o itemspec para determinar quais itens estão dentro do escopo, consulte Usar opções para modificar como um comando funciona.
Observação
Você pode especificar mais de um itemspec argumento.
<versionspec>
O valor fornecido pelo usuário para a opção /version. Para obter mais informações sobre como o TFVC analisa uma especificação de versão para determinar quais itens estão dentro de seu escopo, consulte Usar comandos de controle de versão do Team Foundation.
<username>
Fornece um valor para a opção /login. Você pode especificar um valor de nome de usuário como DOMAIN\username ou username.
<TeamProjectCollectionUrl>
A URL da coleção de projetos que contém um ou mais arquivos ou pastas sobre os quais você deseja exibir informações, por exemplo, http://myserver:8080/tfs/DefaultCollection/.
Opções
Opção
Descrição
/version
Especifica que o TFVC deve mostrar apenas arquivos e pastas de uma determinada versão.
/recursive
Exibe todos os arquivos e subpastas no diretório especificado.
/folders
Exibe somente pastas.
/deleted
Exibe itens excluídos e itens existentes. Os itens excluídos são seguidos com ;Xn onde n é o ID de exclusão.
/login
Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.
/collection
Especifica a coleção de projetos.
Comentários
O comando dir opera nas cópias de arquivos do servidor Azure DevOps, não nas cópias locais. O comando usa a pasta mapeada local para localizar o caminho apropriado do servidor Azure DevOps. Use esse comando para explorar o servidor de DevOps do Azure e identificar os arquivos que talvez seja necessário obter.
Para obter mais informações sobre como usar o utilitário de linha de comando tf, consulte Usar comandos de controle de versão do Team Foundation.
Exemplos
O exemplo a seguir exibe uma lista de arquivos, pastas, subpastas e arquivos na pasta do servidor Azure DevOps para a qual c:\projects mapeia. O número de itens também é listado. Para obter mais informações sobre como exibir e editar mapeamentos de pastas de trabalho, consulte de comando Espaço de trabalho e comando Dobra de trabalho.
c:\projects>tf dir /recursive
O exemplo a seguir exibe todos os arquivos do servidor Azure DevOps no caminho
c:\projects>tf dir 314dir
O exemplo a seguir exibe a versão dos arquivos rotulados como My label no 314dir caminho do servidor Azure DevOps. A subpasta 314dir não precisa existir na pasta local.
c:\projects>tf dir /version:L"My label" 314dir
O exemplo a seguir exibe todas as pastas na raiz do servidor Azure DevOps. A pasta de trabalho local é ignorada, porque $/ denota um caminho de servidor do Azure DevOps.
c:\projects>tf dir /folders $/
O exemplo a seguir lista todos os arquivos e pastas no servidor Azure DevOps.
c:\projects>tf dir /recursive $/
O exemplo a seguir lista todos os itens na pasta atual, incluindo itens excluídos com suas IDs de exclusão.
c:\projects>tf dir /deleted