Comando Dir (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 dir comando exibe todo ou parte do conteúdo do servidor para Team Foundation Version Control (TFVC).

Pré-requisitos

Para usar o comando, você deve ter a dir permissão de Leitura definida como Permitir. Para obter mais informações, consulte Permissões TFVC padrão.

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 para determinar quais itens estão dentro do escopo, consulte Usar opções para modificar o funcionamento de itemspec um comando.

Nota

Você pode especificar mais de um itemspec argumento.

<versionspec>

O valor fornecido pelo usuário para a /version opção. 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 /login opção. Você pode especificar um valor de nome de usuário como ou DOMAIN\usernameusername.

<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 está 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.

Observações

O dir comando 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 tf comando, 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 é mapeado. O número de itens também é listado. Para obter mais informações sobre como exibir e editar mapeamentos de pastas de trabalho, consulte 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 314dir . A subpasta 314dir não precisa existir na pasta local.

c:\projects>tf dir 314dir

O exemplo a seguir exibe a versão dos arquivos rotulados My label no caminho do servidor 314dir 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 $/ indica 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