Comando
CopyFile()
Copia um arquivo para outro caminho. Suporta wildcard para copiar múltiplos arquivos. Cria o diretório de destino automaticamente se não existir.
CopyFile(origem, destino [, sobrescrever])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
origem | Sim | Caminho completo do arquivo de origem. Aceita wildcard * para copiar múltiplos arquivos. |
destino | Sim | Caminho de destino. Pode ser: • Caminho completo do arquivo: @'C:\backup\dados.xlsx'• Pasta de destino (terminar com \): @'C:\backup\' — o nome do arquivo original é preservado. |
sobrescrever | Não | True: sobrescreve o arquivo de destino se já existir. False (padrão): não sobrescreve. |
Exemplos
// Copiar arquivo único:
CopyFile(@'C:\dados\relatorio.xlsx', @'C:\backup\relatorio.xlsx')
// Copiar para pasta (preserva nome):
CopyFile(@'C:\dados\relatorio.xlsx', @'C:\backup\')
// Copiar com sobrescrita:
CopyFile(@'C:\dados\relatorio.xlsx', @'C:\backup\relatorio.xlsx', True)
// Copiar múltiplos arquivos com wildcard:
CopyFile(@'C:\dados\*.xlsx', @'C:\backup\')
// Com variáveis:
CopyFile($origem, $destino, True)Observações
Se a origem não existir, o arquivo é ignorado silenciosamente. Com wildcard, copia todos os arquivos correspondentes para a pasta de destino. O diretório de destino é criado automaticamente se não existir.