FTP

FTP アクション グループを使用して、ファイルをアップロードおよびダウンロードし、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
  • hmac-sha1-96-etm
  • hmac-md5-etm
  • hmac-md5-96-etm

SFTP サーバーで非推奨の暗号化アルゴリズムのみを使用しているユーザーは、デスクトップ用 Power Automate バージョン 2.56 で SFTP 操作を実行する際に処理が失敗する可能性があります。これは、これらのサーバーが更新されたライブラリと互換性がないためです。

スムーズな操作を実現し、業務の流れが滞らないようにするには、次の手順に従います:

  • ご利用の SFTP サーバーがどの暗号化アルゴリズムに対応しているかを確認してください。
  • サーバーで非推奨の暗号化アルゴリズムが使用されている場合は、最新かつ安全な暗号化アルゴリズムに対応するように更新してください。
  • サーバーの暗号化機能のアップグレードについては、IT チームまたは SFTP サーバーのプロバイダーにご相談ください。
  • SFTP サーバーが互換性のあるバージョンに移行されるまでは、バージョン 2.56 以降のインストールを避けてください。

FTP 接続を開く

このアクションを実行すると、リモート FTP サーバーへの特定の接続が確立され、後で使用できるようにその接続が変数として保存されます。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
Host いいえ テキスト値 ここに FTP サーバーのアドレスを入力します。
Port はい 数値 21 ここに FTP サーバーのポートを入力します。
アクティブ モード 在庫切れ ブール値 False 接続のモードを指定
Username いいえ テキスト値 使用する FTP アカウントのユーザー名を指定します
パスワード はい 直接暗号化された入力またはテキスト値 使用する FTP アカウントのパスワードを指定
タイムアウト はい 数値 10 接続の確立を待機する時間 (秒) を設定します。この時間内に接続が確立されない場合には、アクションは失敗します

生成された変数

引数 Type 説明設定
FTPConnection FTP 接続 FTP 接続

例外

例外 内容
ログイン失敗エラー ログインが失敗したことを示します
つながりエラー 接続に問題があることを示します

FTP ディレクトリの一覧表示

このアクションを実行すると、FTP 接続の現在のディレクトリに含まれるサブディレクトリとファイルが返されます。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
Connection いいえ FTP 接続 FTP 接続
Path はい テキスト値 一覧表示するパス。

生成された変数

引数 Type 説明設定
Directories FTP ディレクトリリスト 一覧表示されたディレクトリ
ファイル FTP ファイルリスト 一覧表示されたファイル

例外

例外 Description
一覧表示エラー フォルダーの一覧表示を実行できなかったことを示します
未接続エラー FTP サーバーの開いている接続がないことを示します
「ディレクトリが存在しません」エラー ディレクトリが見つからなかったことを示します

Secure FTP 接続を開く

このアクションを実行すると、リモート FTP サーバーへのセキュリティで保護された特定の接続が確立され、後で使用できるようにその接続が変数として保存されます。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
Host いいえ テキスト値 ここに FTP サーバーのアドレスを入力します。
Port はい 数値 22 ここに FTP サーバーのポートを入力します。
アクティブ モード 在庫切れ ブール値 はい 接続のモードを指定
セキュア FTP プロトコル N/A SFTP、明示的 FTPS、暗黙的 FTPS SFTP 接続の暗号化に使う FTP プロトコルを選択
認証メソッド N/A ユーザー名とパスワード、秘密キー、秘密キーとパスフレーズ ユーザー名とパスワード FTP サーバーで自分自身を認証するために使う方法を選択
ユーザー名 いいえ テキスト値 使用する FTP アカウントのユーザー名を指定します
パスワード はい 直接暗号化された入力またはテキスト値 使用する FTP アカウントのパスワードを指定
秘密キーのパス いいえ テキスト値 認証に使用する秘密キーへのファイル パスを入力します
秘密キーのパス フレーズ はい 直接暗号化された入力またはテキスト値 ここに秘密キーのパスフレーズを含む変数を入力
Timeout はい 数値 10 接続の確立を待機する時間 (秒) を設定します。この時間内に接続が確立されない場合には、アクションは失敗します

生成された変数

引数 Type 説明設定
SftpConnection FTP 接続 SFTP 接続

例外

例外 内容
ログイン失敗エラー ログインが失敗したことを示します
つながりエラー 接続に問題があることを示します

接続を閉じる

このアクションを実行すると、開いている FTP 接続が閉じられます。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
Connection いいえ FTP 接続 FTP 接続

生成された変数

このアクションは変数を生成しません。

例外

例外 Description
未接続エラー FTP サーバーの開いている接続がないことを示します

作業ディレクトリの変更

このアクションを実行すると、FTP 接続用の現在の作業ディレクトリが設定されます。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
Connection いいえ FTP 接続 FTP 接続
作業ディレクトリを設定 いいえ テキスト値 作業ディレクトリとして設定するパスを設定します

生成された変数

このアクションは変数を生成しません。

例外

例外 Description
未接続エラー FTP サーバーの開いている接続がないことを示します
「ディレクトリが存在しません」エラー ディレクトリが見つからなかったことを示します
作業ディレクトリの変更不可エラー 作業ディレクトリを変更できないことを示します

FTP からファイルをダウンロード

1 つまたは複数のファイルを FTP サーバーからダウンロードします。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
フォルダにダウンロード いいえ フォルダー ダウンロードするファイルの保存先となるフォルダー
ダウンロードするファイル いいえ FTP ファイルリスト ダウンロードするファイル
転送の種類 N/A 自動、バイナリ、ASCII 自動 ASCII またはバイナリを入力して、単一のファイルをダウンロードする方法を指定します。 ファイルの種類が不明な場合、または複数のファイルがダウンロードされる場合は、自動を選択してオプションで指定された転送ルールに従います
ファイルが存在する場合 N/A 上書き、ダウンロードしない、一意の名前でダウンロードする 上書きする ファイルが既に存在する場合の処理を指定します。 [上書きする] は、元のファイルに上書きするため、それ以降アクセスできなくなります。一意の名前でダウンロードするは、末尾にアンダースコアと連番を追加します

生成された変数

このアクションは変数を生成しません。

例外

例外 Description
未接続エラー FTP サーバーの開いている接続がないことを示します
「リモート ファイルが存在しません」エラー ファイルが FTP サーバー上に存在しないことを示します
「ディレクトリが存在しません」エラー ディレクトリが見つからなかったことを示します
FTP 接続の中止エラー FTP 接続が中止されたことを示します
ファイルのダウンロード不可エラー ファイルをダウンロードできなかったことを示します

FTP からフォルダーをダウンロード

1 つまたは複数のフォルダーを FTP サーバーからダウンロードします。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
ダウンロードするフォルダ いいえ FTP ディレクトリリスト ダウンロードするフォルダーのパスまたは FTP フォルダーの名前
ローカルフォルダにダウンロード いいえ フォルダー ダウンロードしようとしている FTP フォルダーの保存先の完全なパス

生成された変数

このアクションは変数を生成しません。

例外

例外 Description
未接続エラー FTP サーバーの開いている接続がないことを示します
「リモート ディレクトリが存在しません」エラー ディレクトリが FTP サーバー上に存在しないことを示します
「ディレクトリが存在しません」エラー ディレクトリが見つからなかったことを示します
FTP 接続の中止エラー FTP 接続が中止されたことを示します
ディレクトリのダウンロード不可エラー ディレクトリをダウンロードできなかったことを示します

ファイルを FTP にアップロード

1 つまたは複数のファイルを FTP サーバーにアップロードします。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
アップロードするファイル いいえ ファイルリスト アップロードするファイル
リモート ロケーション はい テキスト値 ファイルをアップロードする場所です
転送タイプ N/A 自動、バイナリ、ASCII 自動 ASCII またはバイナリを入力して、単一のファイルをダウンロードする方法を指定します。 ファイルの種類がわからない場合、または複数のファイルをダウンロードする場合は、[自動] を選択して、オプションで指定された転送ルールに従います
ファイルが存在する場合 N/A 上書き、ダウンロードしない、一意の名前でダウンロードする 上書きする ファイルが既に存在する場合の処理を指定します。 [上書きする] は、元のファイルに上書きするため、それ以降アクセスできなくなります。[一意の名前でダウンロードする] は、末尾にアンダースコアと連番を追加します

生成された変数

このアクションは変数を生成しません。

例外

例外 Description
未接続エラー FTP サーバーの開いている接続がないことを示します
「ファイルが見つかりませんでした」エラー ファイルが見つからなかったことを示します
FTP 接続の中止エラー FTP 接続が中止されたことを示します
ファイルのアップロード エラー ファイルをアップロードできなかったことを示します

フォルダーを FTP にアップロード

1 つまたは複数のフォルダーを FTP サーバーにアップロードします。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
アップロードするフォルダ いいえ フォルダー一覧表示 アップロードするフォルダー。 アップロードするフォルダーは、FTP サーバーのアクティブなディレクトリ内に既に存在していてはなりません
リモート ロケーション いいえ テキスト値 フォルダーをアップロードする場所

生成された変数

このアクションは変数を生成しません。

例外

例外 Description
未接続エラー FTP サーバーの開いている接続がないことを示します
「リモート ディレクトリが存在しません」エラー ディレクトリが FTP サーバー上に存在しないことを示します
FTP 接続の中止エラー FTP 接続が中止されたことを示します
ディレクトリのアップロード エラー ディレクトリをアップロードできなかったことを示します

FTP ファイルを削除

1 つまたは複数のファイルを FTP サーバーから削除します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
削除するファイル いいえ FTP ファイルリスト 削除するファイル

生成された変数

このアクションは変数を生成しません。

例外

例外 Description
未接続エラー FTP サーバーの開いている接続がないことを示します
「ファイルが見つかりませんでした」エラー ファイルが見つからなかったことを示します
ファイルの削除不可エラー ファイルの削除を実行できなかったことを示します

FTP ファイルの名前を変更する

FTP サーバー上にあるファイルの名前を変更します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
名前を変更するファイル いいえ FTP ファイル 名前を変更するファイル
新しいファイル名 いいえ テキスト値 ファイルの新しい名前。 パス付きの名前を入力すると、ファイルがその場所に移動します。 場所が存在しない場合、例外がスローされます

生成された変数

このアクションは変数を生成しません。

例外

例外 Description
未接続エラー FTP サーバーの開いている接続がないことを示します
ファイルの名前変更不可エラー ファイルの名前を変更できなかったことを示します
「ファイルが見つかりませんでした」エラー ファイルが見つからなかったことを示します

FTP ディレクトリの作成

FTP サーバーにディレクトリを作成します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
新規ディレクトリ いいえ FTP ディレクトリ 新しいディレクトリ。 パスを指定すると、新しいディレクトリにつながるすべての新しいフォルダが作成されます

生成された変数

このアクションは変数を生成しません。

例外

例外 説明設定
アクセス拒否エラー このアカウントが操作に対するアクセス権を持っていないことを示します
ファイルの存在エラー ファイルが既に存在することを示します
ディレクトリの作成エラー ディレクトリを作成できなかったことを示します
「ディレクトリが存在しません」エラー ディレクトリが見つからなかったことを示します
未接続エラー FTP サーバーの開いている接続がないことを示します

FTP ディレクトリを削除

FTP サーバーからディレクトリを削除します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
削除するディレクトリ いいえ FTP ディレクトリ 削除するフォルダー。 フォルダ内のすべてが削除されます

生成された変数

このアクションは変数を生成しません。

例外

例外 説明設定
ディレクトリの削除エラー ディレクトリを削除できなかったことを示します
「リモート ディレクトリが存在しません」エラー ディレクトリが FTP サーバー上に存在しないことを示します
作業ディレクトリの変更エラー 作業ディレクトリを変更できなかったことを示します
未接続エラー FTP サーバーの開いている接続がないことを示します

FTP コマンドの呼び出し

サーバー上で指定されたリテラル FTP コマンドを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
FTP コマンド いいえ テキスト値 引数を指定して実行するコマンド。 たとえば、FEAT を実行したり、CHMOD を実行したりすることができます
有効な応答コード はい テキスト値 コマンドから返される可能性のあるコードをセミコロンで区切って指定します。 FTPコマンドがここに入力されていないコードを返した場合、このアクションは例外をスローします。 単純な FTP、または FTPS 接続でのみ適用されます

生成された変数

引数 Type 説明設定
ReplyCode テキスト値 返された実際のコード。 単純な FTP、または FTPS 接続でのみ適用されます
ReplyText テキスト値 FTP サーバーによって返されたテキスト

例外

例外 Description
コマンドの呼び出しエラー FTP コマンドの呼び出し中にエラーが発生したことを示します
未接続エラー FTP サーバーの開いている接続がないことを示します

ディレクトリの同期

指定したフォルダーのファイルとサブディレクトリを特定のリモート FTP ディレクトリと同期します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
FTP 接続 いいえ FTP 接続 作業を行う FTP 接続。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
同期方向 N/A リモート -> ローカル (ダウンロード)、ローカル -> リモート (アップロード) リモート -> ローカル (ダウンロード) 同期化メソッドの方向です。 ローカル フォルダーをリモート ディレクトリに同期させるか (DOWNLOAD)、リモート ディレクトリをローカル フォルダに同期させるか (UPLOAD) を選択します
同期するファイル N/A すべてのファイル、ファイル フィルターに一致するファイルのみ、ファイル フィルターに一致しないファイルのみ すべてのファイル すべてのファイルを同期するか、ファイル フィルターを使って特定のファイルのセットを追加または除外するかを選択します
ファイル フィルター いいえ テキスト値 * 含める、または除外するファイルを制御するファイル名パターン。 このオプションでは、".txt" , "document?.doc" などのワイルドカードを使用することができます。このオプションでは、コマを区切り文字として使用して複数のフィルタを設定することもできます (例 : ".txt,*.pdf,document?")。
ローカルフォルダー いいえ フォルダー 同期するローカル フォルダーの名前
FTP ディレクトリ はい FTP ディレクトリ / 同期する FTP ディレクトリの名前
ソースがない場合は削除する 在庫切れ ブール値 False このオプションを選択すると、ソースではなくターゲット ディレクトリに存在するファイルまたはフォルダーが削除されます。
サブディレクトリを含める 在庫切れ ブール値 はい このオプションを選択すると、同期プロセスにサブディレクトリが含められます。
時差 (時間) はい 数値 0 リモート サーバーが別のタイム ゾーンで稼働している場合の時差 (時間単位) です。
時差 (分) はい 数値 0 リモート サーバーが別のタイム ゾーンで稼働している場合の時差 (分単位) です。
時差 (先) 在庫切れ ブール値 はい サーバーのタイム ゾーンが先行しているかどうかを指定します。

生成された変数

引数 Type 説明設定
FtpFilesAdded FTP ファイルリスト 最初はソースに存在し、同期プロセス後にターゲットに追加された FTP ファイルの一覧です。
FtpFilesModified FTP ファイルリスト 最初はソースとターゲットの両方に存在し、同期プロセス後にターゲットに追加された FTP ファイルの一覧です。
FtpFilesDeleted FTP ファイルリスト 最初はターゲット ディレクトリに存在し、同期プロセス後に削除された FTP ファイルの一覧です。
FilesAdded ファイルリスト 最初はソースに存在し、同期プロセス後にターゲットに追加されたファイルの一覧です。
FilesModified ファイルリスト 最初はソースとターゲットの両方に存在し、同期プロセス後にターゲットに追加されたファイルの一覧です。
FilesDeleted ファイルリスト 最初はターゲット ディレクトリに存在し、同期プロセス後に削除されたファイルの一覧です。

例外

例外 Description
一覧表示エラー フォルダーの一覧表示を実行できなかったことを示します
未接続エラー FTP サーバーの開いている接続がないことを示します
「ファイルが見つかりませんでした」エラー ファイルが見つからなかったことを示します
FTP 接続の中止エラー FTP 接続が中止されたことを示します
ファイルのアップロード エラー ファイルをアップロードできなかったことを示します
「リモート ファイルが存在しません」エラー ファイルが FTP サーバー上に存在しないことを示します
ファイルのダウンロード不可エラー ファイルをダウンロードできなかったことを示します
ディレクトリの削除エラー ディレクトリを削除できなかったことを示します
同期失敗エラー 予期しないエラーによって同期プロセスが失敗したことを示します。