FTP

Используйте группу действий FTP для отправки и скачивания файлов и управления каталогами на FTP-серверах.

Чтобы установить FTP-соединение, используйте действие Открыть подключение FTP. В следующем примере указаны узел, порт и учетные данные. Кроме того, установленный тайм-аут приводит к сбою действия, если соединение не установлено вовремя.

Загрузите файлы с помощью действия Загрузка файлов с FTP. В следующем примере показана используемая переменная подключения и выбранная папка назначения. Удаленный файл также указан и настроен на перезапись всех существующих файлов в том же месте.

Отправляйте файлы с помощью действия Отправить файлы на FTP, указав файл и удаленное расположение.

Внимание!

Начиная с версии 2.56, Power Automate для компьютеров больше не поддерживает устаревшие алгоритмы шифрования, которые устарели в действиях Secure FTP (SFTP). Это обновление призвано повысить безопасность за счет удаления устаревших криптографических методов.

Следующие алгоритмы больше не поддерживаются:

• blowfish-cbc
• Twofish-CBC
• twofish192-cbc
• twofish128-cbc
• twofish256-cbc
• arcfour
• arcfour128
• arcfour256
• cast128-cbc
• hmac-sha2-512-96
• hmac-sha2-256-96
• hmac-sha1-96
• hmac-md5
• hmac-md5-96
• ХМАК-ША1-96-ЭТМ
• ХМАК-МД5-ЭТМ
• ХМАК-МД5-96-ЭТМ

Пользователи, использующие исключительно устаревшие алгоритмы шифрования для своих серверов SFTP, могут столкнуться со сбоем потоков при выполнении действий SFTP в версии 2.56 Power Automate для компьютеров, так как эти серверы несовместимы с обновленной библиотекой.

Чтобы обеспечить бесперебойную работу и избежать сбоев в рабочем процессе, выполните следующие действия:

• Проверьте, какие алгоритмы шифрования поддерживает ваш SFTP-сервер.
• Если на сервере используются устаревшие алгоритмы шифрования, обновите его для поддержки современных и безопасных алгоритмов шифрования.
• Обратитесь к своему ИТ-отделу или поставщику SFTP-сервера за рекомендациями по обновлению криптографических возможностей сервера.
• Не устанавливайте версию 2.56 или более позднюю, пока ваши серверы SFTP не будут переведены на совместимую версию.

Открыть подключение FTP

Это действие устанавливает подключение к удаленному FTP-серверу и сохраняет это подключение в качестве переменной для дальнейшего использования.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
Host	Нет	Текстовое значение		Введите адрес FTP-сервера.
Port	Да	Числовое значение	21	Введите порт FTP-сервера.
Active mode	Н/Д	Логическое значение	Ложь	Укажите режим подключения
Username	Нет	Текстовое значение		Укажите имя пользователя учетной записи FTP
Пароль	Да	Прямой ввод зашифрованного текста или Текстовое значение		Укажите пароль учетной записи FTP
Время ожидания	Да	Числовое значение	10	Задает Время ожидания подключения (в секундах), по истечении которого действие будет признано невыполненным.

Создаваемые переменные

Аргумент	Type	Описаниен
FTPConnection	Подключение FTP	Подключение FTP

Исключения

Исключение	Описание
Ошибка "Не удалось войти"	Указывает, что не удалось войти в систему.
Ошибка подключения	Указывает, что возникла проблема с подключением

Содержание каталога FTP

Это действие возвращает подкаталоги и файлы, содержащиеся в текущем каталоге FTP-подключения.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
Connection	Нет	Подключение FTP		Подключение FTP
Path	Да	Текстовое значение		Путь к каталогу для получения содержания.

Создаваемые переменные

Аргумент	Type	Описаниен
Directories	Списоккаталогов FTP	Список каталогов
Файлы	Списокфайлов FTP	Список файлов

Исключения

Исключение	Описание
Ошибка при получении содержимого папки	Указывает, что не удалось получить содержимое папки.
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Каталог не существует"	Указывает, что найти каталог не удалось.

Отрыть защищенное подключение FTP

Устанавливает защищенное подключение к удаленному FTP-серверу и сохраняет это подключение в качестве переменной для дальнейшего использования.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
Host	Нет	Текстовое значение		Введите адрес FTP-сервера.
Port	Да	Числовое значение	22	Введите порт FTP-сервера.
Active mode	Н/Д	Логическое значение	Истина	Укажите режим подключения
Secure FTP Protocol	Н/Д	SFTP, Явный режим FTPS, Неявный режим FTPS	SFTP	Выберите протокол FTP для шифрования подключения.
Authentication method	Н/Д	Имя пользователя и пароль, Закрытый ключ, Закрытый ключ и парольная фраза	Имя пользователя и пароль	Выберите метод проверки подлинности на FTP-сервере.
User name	Нет	Текстовое значение		Укажите имя пользователя учетной записи FTP
Пароль	Да	Прямой ввод зашифрованного текста или Текстовое значение		Укажите пароль учетной записи FTP
Path to private key	Нет	Текстовое значение		Введите путь к файлу закрытого ключа, который будет использоваться для проверки подлинности
Парольная фраза закрытого ключа	Да	Прямой ввод зашифрованного текста или Текстовое значение		Введите переменную, содержащую парольную фразу закрытого ключа
Timeout	Да	Числовое значение	10	Задает Время ожидания подключения (в секундах), по истечении которого действие будет признано невыполненным.

Создаваемые переменные

Аргумент	Type	Описаниен
SftpConnection	Подключение FTP	Подключение SFTP

Исключения

Исключение	Описание
Ошибка "Не удалось войти"	Указывает, что не удалось войти в систему.
Ошибка подключения	Указывает, что возникла проблема с подключением

Закрыть подключение

Закрывает открытое FTP-подключение.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
Connection	Нет	Подключение FTP		Подключение FTP

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описание:
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу

Изменить рабочий каталог

Задает текущий рабочий каталог для FTP-подключения.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
Connection	Нет	Подключение FTP		Подключение FTP
Set working directory to	Нет	Текстовое значение		Установка пути для рабочего каталога

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описание:
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Каталог не существует"	Указывает, что найти каталог не удалось.
Ошибка "Невозможно изменить рабочий каталог"	Указывает, что изменить рабочий каталог невозможно.

Загрузить файлы с FTP-сервера

Загружает один или несколько файлов с FTP-сервера.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
Download into folder	Нет	Папка		Папка, в которую будут загружены файлы
Файлы для загрузки	Нет	Списокфайлов FTP		Файлы для загрузки
Тип передачи	Неприменимо	Авто, Двоичный, ASCII	Авто	Введите ASCII или "Двоичный", чтобы указать метод загрузки одного файла. Если тип файла неизвестен или загружается несколько файлов, выберите "Авто", чтобы следовать правилам передачи, указанным в параметрах
If file exists	Н/Д	Перезаписать, Не загружать, Загрузить с уникальным именем	Перезаписать	Укажите, что делать, если файл уже существует. "Перезаписать" перезаписывает имеющийся файл (т. е. доступ к нему будет утрачен), а "Загрузить с уникальным именем" добавляет символ подчеркивания и порядковый номер в конце имени

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описание:
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Удаленный файл не существует"	Указывает, что файл отсутствует на FTP-сервере.
Ошибка "Каталог не существует"	Указывает, что найти каталог не удалось.
Ошибка "Подключение FTP прервано"	Указывает, что подключение FTP прервано.
Ошибка "Невозможно загрузить файл"	Указывает, что загрузить файл невозможно.

Загрузить папки с FTP-сервера

Загружает одну или несколько папок с FTP-сервера.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
Folder(s) to download	Нет	Списоккаталогов FTP		Имена путей к папкам или FTP-папкам для загрузки
Download into local folder	Нет	Папка		Полный путь к месту назначения загружаемых FTP-папок

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описание:
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Удаленный каталог не существует"	Указывает, что каталог отсутствует на FTP-сервере.
Ошибка "Каталог не существует"	Указывает, что найти каталог не удалось.
Ошибка "Подключение FTP прервано"	Указывает, что подключение FTP прервано.
Ошибка "Невозможно загрузить каталог"	Указывает, что загрузить каталог невозможно.

Отправить файлы на FTP

Отправляет один или несколько файлов на FTP-сервер.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
File(s) to upload	Нет	Списокфайлов		Файлы для отправки
Remote location	Да	Текстовое значение		Расположение, в которое должны быть отправлены файлы
Transfer type	Н/Д	Авто, Двоичный, ASCII	Авто	Введите ASCII или "Двоичный", чтобы указать метод загрузки одного файла. Если тип файла неизвестен или загружается более одного файла, выберите "Авто", чтобы следовать правилам передачи файлов, заданным в параметрах
If file exists	Н/Д	Перезаписать, Не загружать, Загрузить с уникальным именем	Перезаписать	Укажите, что делать, если файл уже существует. "Перезаписать" перезаписывает имеющийся файл (т. е. доступ к нему будет утрачен), а "Загрузить с уникальным именем" добавляет символ подчеркивания и порядковый номер в конце имени

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описание:
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Файл не найден"	Указывает, что файл не найден.
Ошибка "Подключение FTP прервано"	Указывает, что подключение FTP прервано.
Ошибка при отправке файла	Указывает, что отправить файл не удалось.

Отправить папки на FTP

Отправляет одну или несколько папок на FTP-сервер.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
Folder(s) to upload	Нет	Списокпапок		Папки для отправки. Отправляемые папки еще не должны уже существовать в активном каталоге на FTP-сервере
Remote location	Нет	Текстовое значение		Расположение, в которое должны быть отправлены папки

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описание:
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Удаленный каталог не существует"	Указывает, что каталог отсутствует на FTP-сервере.
Ошибка "Подключение FTP прервано"	Указывает, что подключение FTP прервано.
Ошибка при отправке каталога	Указывает, что отправить каталог не удалось.

Удалить файл FTP

Удаляет один или несколько файлов с FTP-сервера.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии «Открыть подключение FTP»
Файлы для удаления	Нет	Списокфайлов FTP		Файлы для удаления

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описание:
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Файл не найден"	Указывает, что файл не найден.
Ошибка "Невозможно удалить файл"	Указывает, что удаление файла невозможно.

Переименовать файл FTP

Переименовывает файл на FTP-сервере.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии «Открыть подключение FTP»
Файлы для переименования	Нет	Файл FTP		Файл для переименования
Новое имя файла	Нет	Текстовое значение		Новое имя файла. Если вы введете имя с путем, файл также будет перемещен в это место. Если расположение не существует, будет выдано исключение

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описание:
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Невозможно переименовать файл"	Указывает, что переименовать файл невозможно.
Ошибка "Файл не найден"	Указывает, что файл не найден.

Создать каталог FTP

Создает каталог на FTP-сервере.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
New directory	Нет	Каталог FTP		Новый каталог. Если указан путь, будут созданы все новые папки, ведущие к новому каталогу

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описаниен
Ошибка "Доступ запрещен"	Указывает, что у этой учетной записи нет доступа к операции.
Ошибка "Файл не существует"	Указывает, что файл уже существует.
Ошибка при создании каталога	Указывает, что создать каталог невозможно.
Ошибка "Каталог не существует"	Указывает, что найти каталог не удалось.
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу

Удаляемый каталог FTP

Удаляет каталог с FTP-сервера.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
Directory to delete	Нет	Каталог FTP		Папка, которую нужно удалить. Все содержимое папки также будет удалено

Создаваемые переменные

Это действие не создает никаких переменных.

Исключения

Исключение	Описаниен
Ошибка при удалении каталога	Указывает, что удалить каталог невозможно.
Ошибка "Удаленный каталог не существует"	Указывает, что каталог отсутствует на FTP-сервере.
Ошибка изменения рабочего каталога	Указывает, что изменить рабочий каталог не удалось.
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу

Вызвать команду FTP

Вызывает заданную команду FTP на сервере.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
FTP command	Нет	Текстовое значение		Команда для запуска вместе с любыми аргументами. Например, здесь можно запустить FEAT или CHMOD
Valid reply code(s)	Да	Текстовое значение		Коды, которые может вернуть команда, разделенные точкой с запятой. Если команда FTP возвращает код, который здесь не был введен, это действие вызовет исключение. Применяется только к простым подключениям FTP или FTPS

Создаваемые переменные

Аргумент	Type	Описаниен
ReplyCode	Текстовое значение	Фактический код, который был возвращен. Применяется только к простым подключениям FTP или FTPS
ReplyText	Текстовое значение	Текст, возвращенный FTP-сервером

Исключения

Исключение	Описание:
Ошибка вызова команды	Указывает, что при вызове команды FTP произошла ошибка.
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу

Синхронизировать каталоги

Синхронизирует файлы и подкаталоги в заданной папке с заданным удаленным каталогом FTP.

Входные параметры

Аргумент	Необязательно	Принимает	Значение по умолчанию	Описаниен
FTP connection	Нет	Подключение FTP		Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии «Открыть подключение FTP»
Synchronization direction	Неприменимо	Удаленное -> локальное (загрузка), Локальное -> удаленное (отправка)	Удаленное -> локальное (загрузка)	Направление метода синхронизации. Вы можете синхронизировать локальный каталог с удаленным каталогом (ЗАГРУЗКА) или удаленный каталог с локальным (ОТПРАВКА)
Files to sync	Н/Д	Все файлы, Только файлы, соответствующие фильтру файлов, Только файлы, не соответствующие фильтру файлов	Все файлы	Выберите, нужно ли синхронизировать все файлы или же вы ограничите их набор с помощью фильтра.
Фильтр файлов	Нет	Текстовое значение	*	Шаблон имени файла, который определяет, какие файлы будут включены или исключены. Этот параметр позволяет использовать подстановочные знаки, например ".txt" или "document?.doc". Вы также можете задать несколько фильтров, используя в качестве разделителя запятую: ".txt,*.pdf,document?"
Local folder	Нет	Папка		Имя локальной папки для синхронизации
FTP directory	Да	Каталог FTP	/	Имя каталога FTP для синхронизации
Delete if source is absent	Н/Д	Логическое значение	False	Эта команда удалит файл или папку, которые существуют в целевом каталоге, но не в исходном.
Include subdirectories	Н/Д	Логическое значение	Истина	Этот параметр включит в процесс синхронизации подкаталоги.
Time difference in hours	Да	Числовое значение	0	Отличие времени удаленного сервера в часах, если сервер работает в другом часовом поясе.
Time difference in minutes	Да	Числовое значение	0	Отличие времени удаленного сервера в минутах, если сервер работает в другом часовом поясе.
Time difference ahead	Н/Д	Логическое значение	Истина	Укажите, опережает ли часовой пояс сервера локальный.

Создаваемые переменные

Аргумент	Type	Описаниен
FtpFilesAdded	Списокфайлов FTP	Список файлов FTP, которые изначально присутствовали в исходной папке и после синхронизации были добавлены в целевой каталог.
FtpFilesModified	Списокфайлов FTP	Список файлов FTP, которые изначально присутствовали как в исходной папке, так и в целевом каталоге, и после синхронизации были добавлены в целевой каталог.
FtpFilesDeleted	Списокфайлов FTP	Список файлов FTP, которые изначально присутствовали в целевом каталоге и после синхронизации были удалены.
FilesAdded	Списокфайлов	Список файлов, которые изначально присутствовали в исходной папке и после синхронизации были добавлены в целевой каталог.
FilesModified	Списокфайлов	Список файлов, которые изначально присутствовали как в исходной папке, так и в целевом каталоге, и после синхронизации были добавлены в целевой каталог.
FilesDeleted	Списокфайлов	Список файлов, которые изначально присутствовали в целевом каталоге и после синхронизации были удалены.

Исключения

Исключение	Описание:
Ошибка при получении содержимого папки	Указывает, что не удалось получить содержимое папки.
Ошибка "Нет подключения"	Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Файл не найден"	Указывает, что файл не найден.
Ошибка "Подключение FTP прервано"	Указывает, что подключение FTP прервано.
Ошибка при отправке файла	Указывает, что отправить файл не удалось.
Ошибка "Удаленный файл не существует"	Указывает, что файл отсутствует на FTP-сервере.
Ошибка "Невозможно загрузить файл"	Указывает, что загрузить файл невозможно.
Ошибка при удалении каталога	Указывает, что удалить каталог невозможно.
Ошибка "Сбой синхронизации"	Указывает, что произошел сбой процесса синхронизации из-за непредвиденной ошибки.