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 サーバー上に存在しないことを示します |
| ファイルのダウンロード不可エラー | ファイルをダウンロードできなかったことを示します |
| ディレクトリの削除エラー | ディレクトリを削除できなかったことを示します |
| 同期失敗エラー | 予期しないエラーによって同期プロセスが失敗したことを示します。 |