Ações de pasta
Importante
Para evitar o acesso não autorizado, o Windows exige direitos de administrador para acessar as pastas protegidas. Para acessar esses recursos usando as ações da pasta, execute o Power Automate com direitos de administrador. Para obter mais informações sobre como executar o Power Automate como administrador, acesse Executar o Power Automate com direitos elevados.
As ações das pastas do Power Automate permitem que você manipule e organize as pastas.
A ação Obter pasta especial recupera os caminhos para diretórios comumente usados que variam entre diferentes usuários e computadores. O exemplo a seguir recupera o diretório da área de trabalho e o armazena em uma variável.
Agora você pode usar a variável %SpecialFolderPath% sempre que for necessário, independentemente do usuário que executa o fluxo ou do computador no qual ele é executado.
Crie pastas com a ação Criar pasta.
Para obter uma lista do conteúdo de uma pasta, use a ação Obter subpastas na pasta. Essa ação recupera uma lista de pastas localizadas na pasta especificada. O exemplo a seguir recupera todas as subpastas de uma pasta especial especificada. Na seção Avançada você pode ver que a ação classifica os resultados por hora de criação em ordem crescente e nome em ordem decrescente.
Você também pode copiar, mover, renomear e excluir ou esvaziar pastas usando as ações apropriadas.
Se a pasta existir
Marcar o início de um bloco de ações condicional dependendo se uma pasta existe ou não.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Descrição |
|---|---|---|---|---|
| Se a pasta | N/D | Existe, Não existe | Existe | Escolher o estado da pasta a ser verificada |
| Caminho da pasta | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta para verificar seu estado |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
Essa ação não inclui exceções.
Obter arquivos na pasta
Recupere a lista de arquivos em uma pasta.
Para recuperar todos os arquivos em uma pasta específica, use a ação Obter arquivos na pasta. Especifique o caminho da pasta na propriedade Pasta e use o caractere * na propriedade Filtro de arquivo (incluído por padrão). Caso você queira adicionar também todos os arquivos incluídos na subpasta dentro da pasta especificada, ative a opção Incluir subpastas. Os caminhos de arquivos recuperados são então armazenados na saída da ação.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Pasta | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta para recuperar a lista de arquivos | |
| Filtro de arquivo | Não | Valor do texto | * | Escolha um filtro para limitar os arquivos recuperados. Este parâmetro permite curingas, por exemplo, *.txt ou documento?.doc. Para permitir vários filtros de arquivo, separe as opções por ponto e vírgula, por exemplo, .txt;.exe. |
| Incluir subpastas | N/D | Valor booliano | Falso | Especificar se as subpastas também devem ser pesquisadas |
| Falha em acesso negado a qualquer subpasta | N/D | Valor booliano | Verdadeiro | Especificar se deve acionar um erro ao tentar obter arquivos de uma pasta sem direitos de acesso ou se deve ignorar essas pastas |
| Classificar por | N/D | Sem classificação, Nome completo, Caminho raiz, Diretório, Nome, Nome sem extensão, Extensão, Tamanho, Hora de criação, Último acesso, Última modificação, Está oculto, É sistema, É somente leitura, É arquivo, Existe | Sem classificação | Especificar se os resultados devem ser classificados e por que critérios |
| Decrescente | N/D | Valor booliano | Falso | Especificar se os itens devem ser classificados em ordem crescente ou decrescente |
| Em seguida por | N/D | Sem classificação, Nome completo, Caminho raiz, Diretório, Nome, Nome sem extensão, Extensão, Tamanho, Hora de criação, Último acesso, Última modificação, Está oculto, É sistema, É somente leitura, É arquivo, Existe | Sem classificação | Especificar se os resultados devem ser classificados por um segundo critério |
| Decrescente | N/D | Valor booliano | Falso | Especificar se os itens devem ser classificados em ordem crescente ou decrescente |
| Em seguida por | N/D | Sem classificação, Nome completo, Caminho raiz, Diretório, Nome, Nome sem extensão, Extensão, Tamanho, Hora de criação, Último acesso, Última modificação, Está oculto, É sistema, É somente leitura, É arquivo, Existe | Sem classificação | Especificar se os resultados devem ser classificados por um terceiro critério |
| Decrescente | N/D | Valor booliano | Falso | Especificar se os itens devem ser classificados em ordem crescente ou decrescente |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| Arquivos | Lista de Arquivos | Os arquivos recuperados como uma lista de objetos de arquivo |
Exceções
| Exceção | Descrição |
|---|---|
| A pasta não existe | Indica que a pasta não foi encontrada |
| Não é possível recuperar lista de arquivos | Indica um problema ao recuperar a lista de arquivos |
Obter subpastas na pasta
Recupere a lista de subpastas em uma pasta.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Pasta | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta para recuperar a lista de subpastas | |
| Filtro de pasta | Não | Valor do texto | * | Escolha um filtro para limitar as subpastas recuperadas. Este parâmetro permite curingas, por exemplo, Doc* ou Documento?. Para permitir vários filtros de pasta, separe as opções com um ponto e vírgula; por exemplo, Doc*;*. |
| Incluir subpastas | N/A | Valor booliano | Falso | Especificar se deve pesquisar as subpastas e recuperar as respectivas subpastas (e assim por diante) também |
| Falha em acesso negado a qualquer subpasta | N/D | Valor booliano | Verdadeiro | Especificar se deve acionar um erro ao tentar obter subpastas de uma pasta sem direitos de acesso ou se deve ignorar essas pastas |
| Classificar por | N/D | Sem classificação, Nome completo, Caminho raiz, Diretório, Nome, Nome sem extensão, Extensão, Tamanho, Hora de criação, Último acesso, Última modificação, Está oculto, É sistema, É somente leitura, É arquivo, Existe | Sem classificação | Especificar se os resultados devem ser classificados e por que critérios |
| Decrescente | N/D | Valor booliano | Falso | Especificar se os itens devem ser classificados em ordem crescente ou decrescente |
| Em seguida por | N/D | Sem classificação, Nome completo, Caminho raiz, Diretório, Nome, Nome sem extensão, Extensão, Tamanho, Hora de criação, Último acesso, Última modificação, Está oculto, É sistema, É somente leitura, É arquivo, Existe | Sem classificação | Especificar se os resultados devem ser classificados por um segundo critério |
| Decrescente | N/D | Valor booliano | Falso | Especificar se os itens devem ser classificados em ordem crescente ou decrescente |
| Em seguida por | N/D | Sem classificação, Nome completo, Caminho raiz, Diretório, Nome, Nome sem extensão, Extensão, Tamanho, Hora de criação, Último acesso, Última modificação, Está oculto, É sistema, É somente leitura, É arquivo, Existe | Sem classificação | Especificar se os resultados devem ser classificados por um terceiro critério |
| Decrescente | N/D | Valor booliano | Falso | Especificar se os itens devem ser classificados em ordem crescente ou decrescente |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| Pastas | Lista de Pastas | As subpastas recuperadas como uma lista de objetos de pasta |
Exceções
| Exceção | Descrição |
|---|---|
| A pasta não existe | Indica que a pasta não foi encontrada |
| Não é possível recuperar lista de subpastas | Indica um problema ao recuperar a lista de subpastas |
Criar pasta
Criar uma nova pasta.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Descrição |
|---|---|---|---|---|
| Criar nova pasta em | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta para criar a nova pasta | |
| Nome da nova pasta | Não | Valor do texto | Insira o texto ou a variável de texto para ser o nome da nova pasta |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| NewFolder | Pasta | O objeto da pasta criado (que é uma representação e pode acessar a pasta e respectivas informações) |
Exceções
| Exceção | Descrição |
|---|---|
| A pasta não existe | Indica que a pasta não foi encontrada |
| Não é possível criar pasta | Indica um problema ao criar a pasta |
| O caminho e o nome da nova pasta estão vazios | Indica que o caminho da nova pasta e o nome dela não têm nenhum valor |
Excluir pasta
Excluir uma pasta existente e seu conteúdo (arquivos e subpastas).
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Descrição |
|---|---|---|---|---|
| Pasta a ser excluída | Não | Pasta | Insira ou escolha o caminho completo da pasta ou uma variável que contenha a pasta a ser excluída. Lembre-se de que todo o conteúdo dessa pasta e de suas subpastas também será excluído. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção | Descrição |
|---|---|
| A pasta não existe | Indica que a pasta não foi encontrada |
| Não é possível excluir a pasta | Indica um problema ao excluir a pasta |
Esvaziar pasta
Exclua todo o conteúdo de uma pasta (arquivos e subpastas) sem excluir a própria pasta.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Descrição |
|---|---|---|---|---|
| Pasta a ser esvaziada | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta para excluir seu conteúdo |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção | Descrição |
|---|---|
| A pasta não existe | Indica que a pasta não foi encontrada |
| Não é possível excluir conteúdo da pasta | Indica um problema ao limpar o conteúdo da pasta |
Copiar pasta
Copie uma pasta para uma pasta de destino.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Descrição |
|---|---|---|---|---|
| Pasta a ser copiada | Não | Pasta | Insira ou escolha o caminho completo da pasta ou uma variável que contenha a pasta a ser copiada. Se o caminho da pasta terminar com \, apenas o conteúdo da pasta (arquivos + subpastas) será copiado. Caso contrário, a própria pasta (junto com seu conteúdo) será copiada como uma subpasta na pasta de destino. | |
| Pasta de destino | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta como a pasta de destino | |
| Se a pasta existir | N/D | Não faça nada, Substituir | Não faça nada | Especifique se deseja substituir os arquivos ou não copiá-los, se a pasta de destino já existir. Se a pasta existir, mas os arquivos tiverem nomes diferentes, os arquivos antigos ainda permanecerão na pasta. |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| CopiedFolder | Pasta | O objeto da pasta copiado (que é uma representação e pode acessar a pasta e respectivas informações) |
Exceções
| Exceção | Descrição |
|---|---|
| A pasta não existe | Indica que a pasta não foi encontrada |
| A pasta de destino não existe | Indica que a pasta de destino não foi encontrada |
| Não é possível copiar pasta | Indica um problema ao copiar a pasta |
Mover pasta
Mova uma pasta existente para uma pasta de destino.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Descrição |
|---|---|---|---|---|
| Pasta a ser movida | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta para mover | |
| Pasta de destino | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta como a pasta de destino |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| MovedFolder | Pasta | O objeto da pasta movida (que é uma representação e pode acessar a pasta e respectivas informações) |
Exceções
| Exceção | Descrição |
|---|---|
| A pasta não existe | Indica que a pasta não foi encontrada |
| A pasta de destino não existe | Indica que a pasta de destino não foi encontrada |
| Não é possível mover pasta | Indica um problema ao mover a pasta |
Renomear pasta
Alterar o nome de uma pasta.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Descrição |
|---|---|---|---|---|
| Pasta a ser renomeada | Não | Pasta | Inserir ou escolher o caminho completo da pasta ou uma variável que contenha a pasta para alterar seu nome | |
| Nome da nova pasta | Não | Valor do texto | Insira o texto ou a variável de texto para ser o novo nome da pasta |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| RenamedFolder | Pasta | O objeto da pasta renomeada (que é uma representação e pode acessar a pasta e respectivas informações) |
Exceções
| Exceção | Descrição |
|---|---|
| A pasta não existe | Indica que a pasta não foi encontrada |
| Não é possível renomear pasta | Indica um problema ao renomear a pasta |
Obter pasta especial
Recuperar o caminho de uma pasta especial do Windows (como Área de Trabalho, Minhas Imagens, Cache da Internet etc).
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Descrição |
|---|---|---|---|---|
| Nome da pasta especial | N/D | Programas, Pessoal, Favoritos, Inicialização, Recentes, Enviar para, Menu Iniciar, Música, Área de Trabalho, Modelos, Dados de aplicativos, Dados de aplicativos locais, Cache de Internet, Cookies, Histórico, Dados de aplicativos comuns, Sistema, Arquivos de programas, Imagens, Arquivos de programas comuns | Área de Trabalho | Escolha o nome da pasta especial (como Meus Documentos ou Área de Trabalho). Esta opção é independente do caminho, para localizar a pasta especial em qualquer computador, independentemente das especificações do caminho. |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| SpecialFolderPath | Pasta | O objeto da pasta especial (que é uma representação e pode acessar a pasta e respectivas informações) |
Exceções
Essa ação não inclui exceções.