Comando
DirectorySubdirectories()
Lista subpastas de um diretório e carrega os caminhos completos em uma variável de lista. Utilizado como fonte de dados para o Foreach(), iterando pasta por pasta. Equivalente ao DirectoryFiles() mas para diretórios em vez de arquivos.
Propriedades disponíveis dentro do Foreach:
O caminho retornado em
Propriedades disponíveis dentro do Foreach:
$variavel.Count: total de subpastas encontradas$variavel.$Item: caminho completo da pasta atualO caminho retornado em
$Item é sempre o caminho completo e absoluto da subpasta.
DirectorySubdirectories(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: $pastas. |
diretorio | Sim | Caminho do diretório pai a listar. Ex: @'C:\projetos'. |
mascara | Sim | Padrão de filtro de nome de pasta. Ex: '*', '2024*'. Use '*' para todas as subpastas. |
SubDirectories | Não | Informe SubDirectories para busca recursiva (inclui subpastas de subpastas). Se omitido, lista apenas o nível imediatamente abaixo. |
Exemplos
// Listar todas as subpastas:
DirectorySubdirectories($pastas, @'C:\clientes', '*')
Output($pastas.Count + ' pastas encontradas')
Foreach ($pastas) {
Output($pastas.$Item)
}