Comando
DownloadFile()
Faz o download de um arquivo a partir de uma URL HTTP/HTTPS e o salva no caminho local especificado. Se o caminho de destino for um diretório, o nome do arquivo é extraído da URL automaticamente.
DownloadFile(url, caminho)
Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
url | Sim | URL completa do arquivo a baixar (HTTP ou HTTPS). Aceita variáveis. |
caminho | Sim | Caminho de destino local. Pode ser: • Caminho completo com nome do arquivo: @'C:\downloads\arquivo.pdf'• Somente o diretório (sem extensão no último segmento): @'C:\downloads' — o nome do arquivo é extraído da URL. |
Exemplos
// Download com caminho completo:
DownloadFile('https://exemplo.com/relatorio.pdf', @'C:\downloads\relatorio.pdf')
// Download — nome extraído da URL:
DownloadFile('https://exemplo.com/arquivos/dados.csv', @'C:\downloads')
// Com variável na URL:
DownloadFile('https://api.exemplo.com/export?id=' + $id, @'C:\temp\export.xlsx')
Observações
Execução síncrona (aguarda o download concluir antes de continuar). Para URLs com caracteres especiais, elas são decodificadas automaticamente (UrlDecode) antes de extrair o nome do arquivo.