Comando
DirectoryFiles()
Lista arquivos em um diretório e carrega os caminhos completos em uma variável de lista. Utilizado como fonte de dados para o Foreach(), iterando arquivo por arquivo. Suporta máscara de filtro e busca recursiva em subpastas.
Propriedades disponíveis dentro do Foreach:
O caminho retornado em
Propriedades disponíveis dentro do Foreach:
$variavel.Count: total de arquivos encontrados$variavel.$Item: caminho completo do arquivo atual (ex: C:\entrada\dados.xlsx)O caminho retornado em
$Item é sempre o caminho completo e absoluto. Use funções como GetFileName() para extrair apenas o nome do arquivo.
DirectoryFiles(variavel, diretorio, mascara [, SubDirectories])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
variavel | Sim | Nome da variável de lista. Deve começar com $. Ex: $arquivos. |
diretorio | Sim | Caminho do diretório a listar. Ex: @'C:\entrada'. |
mascara | Sim | Padrão de filtro de nome de arquivo. Ex: '*.*', '*.xlsx', 'relatorio_*'. Use '*' ou '*.*' para todos os arquivos. |
SubDirectories | Não | Informe SubDirectories para incluir arquivos de subpastas recursivamente. Se omitido, lista apenas o diretório raiz informado. |
Exemplos
// Listar todos os arquivos de uma pasta e subpastas:
DirectoryFiles($arquivos, @'C:\entrada', '*.*', SubDirectories)
Output($arquivos.Count + ' arquivos encontrados')
Foreach ($arquivos) {
Output($arquivos.$Item)
}