FTP アクション グループを使用して、ファイルをアップロードおよびダウンロードし、FTP サーバー上のディレクトリを操作します。
FTP 接続を確立するには、FTP 接続を開く アクションを使用します。 次の例では、ホスト、ポート、資格情報が指定されています。 さらに、設定されたタイムアウトにより、接続が時間どおりに確立されない場合、アクションは失敗します。
FTP からファイルをダウンロード アクションを使用してファイルをダウンロードします。 次の例は、使用中の接続変数と選択された保存先フォルダーを示しています。 リモート ファイルも指定され、同じ場所にある既存のファイルを上書きするように設定されています。
ファイルとリモートの場所を指定して、ファイルを FTP にアップロード アクションを使用し、ファイルをアップロードします。
重要
バージョン 2.56 以降、デスクトップ用 Power Automate は、Secure FTP (SFTP) アクションで非推奨のレガシー暗号アルゴリズムをサポートしなくなりました。 この更新プログラムは、古い暗号化方法を削除することでセキュリティを強化することを目的としています。
次のアルゴリズムがサポートされなくなりました。
- blowfish-cbc
- twofish-cbc
- ツーフィッシュ192-CBC
- ツーフィッシュ128-CBC
- ツーフィッシュ256-CBC
- アークフォー
- アークフォー128
- アークフォー256
- キャスト128-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 サーバーへの特定の接続が確立され、後で使用できるようにその接続が変数として保存されます。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Host | いいえ | テキスト値 | ここに FTP サーバーのアドレスを入力します。 | |
Port | はい | 数値 | 21 | ここに FTP サーバーのポートを入力します。 |
Active mode | N/A | ブール値 | 無効 | 接続のモードを指定 |
Username | いいえ | テキスト値 | 使用する FTP アカウントのユーザー名を指定 | |
パスワード | はい | 直接暗号化された入力またはテキスト値 | 使用する FTP アカウントのパスワードを指定 | |
タイムアウト | はい | 数値 | 10 | 接続の確立を待機する時間 (秒) を設定します。この時間内に接続が確立されない場合には、アクションは失敗します |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
FTPConnection | FTP 接続 | FTP 接続 |
例外
例外 | 内容 |
---|---|
ログイン失敗エラー | ログインが失敗したことを示します |
つながりエラー | 接続に問題があることを示します |
FTP ディレクトリの一覧表示
このアクションを実行すると、FTP 接続の現在のディレクトリに含まれるサブディレクトリとファイルが返されます。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Connection | いいえ | FTP 接続 | FTP 接続 | |
Path | はい | Text 値 | 一覧表示するパス。 |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
Directories | FTP ディレクトリ のリスト | 一覧表示されたディレクトリ |
ファイル | FTP ファイル のリスト | 一覧表示されたファイル |
例外
例外 | 説明設定 |
---|---|
一覧表示エラー | フォルダーの一覧表示を実行できなかったことを示します |
未接続エラー | FTP サーバーの開いている接続がないことを示します |
「ディレクトリが存在しません」エラー | ディレクトリが見つからなかったことを示します |
Secure FTP 接続を開く
このアクションを実行すると、リモート FTP サーバーへのセキュリティで保護された特定の接続が確立され、後で使用できるようにその接続が変数として保存されます。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Host | いいえ | テキスト値 | ここに FTP サーバーのアドレスを入力します。 | |
Port | はい | 数値 | 22 | ここに FTP サーバーのポートを入力します。 |
Active mode | N/A | ブール値 | 有効 | 接続のモードを指定 |
Secure FTP Protocol | N/A | SFTP、明示的 FTPS、暗黙的 FTPS | SFTP | 接続の暗号化に使う FTP プロトコルを選択 |
Authentication method | N/A | ユーザー名とパスワード、秘密キー、秘密キーとパスフレーズ | ユーザー名とパスワード | FTP サーバーで自分自身を認証するために使う方法を選択 |
User name | いいえ | テキスト値 | 使用する FTP アカウントのユーザー名を指定 | |
パスワード | はい | 直接暗号化された入力またはテキスト値 | 使用する FTP アカウントのパスワードを指定 | |
Path to private key | いいえ | テキスト値 | 認証に使う秘密キーへのファイル パスを入力 | |
秘密キーのパス フレーズ | はい | 直接暗号化された入力またはテキスト値 | ここに秘密キーのパスフレーズを含む変数を入力 | |
Timeout | はい | 数値 | 10 | 接続の確立を待機する時間 (秒) を設定します。この時間内に接続が確立されない場合には、アクションは失敗します |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
SftpConnection | FTP 接続 | SFTP 接続 |
例外
例外 | 内容 |
---|---|
ログイン失敗エラー | ログインが失敗したことを示します |
つながりエラー | 接続に問題があることを示します |
接続を閉じる
このアクションを実行すると、開いている FTP 接続が閉じられます。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
接続 | いいえ | FTP 接続 | FTP 接続 |
生成された変数
このアクションは変数を生成しません。
例外
例外 | Description |
---|---|
未接続エラー | FTP サーバーの開いている接続がないことを示します |
作業ディレクトリの変更
このアクションを実行すると、FTP 接続用の現在の作業ディレクトリが設定されます。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
Connection | いいえ | FTP 接続 | FTP 接続 | |
Set working directory to | いいえ | Text 値 | 作業ディレクトリとして設定するパスを設定します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | Description |
---|---|
未接続エラー | FTP サーバーの開いている接続がないことを示します |
「ディレクトリが存在しません」エラー | ディレクトリが見つからなかったことを示します |
作業ディレクトリの変更不可エラー | 作業ディレクトリを変更できないことを示します |
FTP からファイルをダウンロード
1 つまたは複数のファイルを FTP サーバーからダウンロードします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
Download into folder | いいえ | フォルダー | ダウンロードするファイルの保存先となるフォルダー | |
ダウンロードするファイル | いいえ | FTP ファイル のリスト | ダウンロードするファイル | |
転送の種類 | N/A | 自動、バイナリ、ASCII | 自動 | ASCII またはバイナリを入力して、単一のファイルをダウンロードする方法を指定します。 ファイルの種類が不明な場合、または複数のファイルがダウンロードされる場合は、自動を選択してオプションで指定された転送ルールに従います |
If file exists | N/A | 上書き、ダウンロードしない、一意の名前でダウンロードする | 上書きする | ファイルが既に存在する場合の処理を指定します。 [上書きする] は、元のファイルに上書きするため、それ以降アクセスできなくなります。一意の名前でダウンロードするは、末尾にアンダースコアと連番を追加します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | Description |
---|---|
未接続エラー | FTP サーバーの開いている接続がないことを示します |
「リモート ファイルが存在しません」エラー | ファイルが FTP サーバー上に存在しないことを示します |
「ディレクトリが存在しません」エラー | ディレクトリが見つからなかったことを示します |
FTP 接続の中止エラー | FTP 接続が中止されたことを示します |
ファイルのダウンロード不可エラー | ファイルをダウンロードできなかったことを示します |
FTP からフォルダーをダウンロード
1 つまたは複数のフォルダーを FTP サーバーからダウンロードします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
Folder(s) to download | いいえ | FTP ディレクトリ のリスト | ダウンロードするフォルダーのパスまたは FTP フォルダーの名前 | |
Download into local folder | いいえ | フォルダー | ダウンロードしようとしている FTP フォルダーの保存先の完全なパス |
生成された変数
このアクションは変数を生成しません。
例外
例外 | Description |
---|---|
未接続エラー | FTP サーバーの開いている接続がないことを示します |
「リモート ディレクトリが存在しません」エラー | ディレクトリが FTP サーバー上に存在しないことを示します |
「ディレクトリが存在しません」エラー | ディレクトリが見つからなかったことを示します |
FTP 接続の中止エラー | FTP 接続が中止されたことを示します |
ディレクトリのダウンロード不可エラー | ディレクトリをダウンロードできなかったことを示します |
ファイルを FTP にアップロード
1 つまたは複数のファイルを FTP サーバーにアップロードします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
File(s) to upload | いいえ | ファイル の リスト | アップロードするファイル | |
Remote location | はい | テキスト値 | ファイルをアップロードする場所です | |
Transfer type | N/A | 自動、バイナリ、ASCII | 自動 | ASCII またはバイナリを入力して、単一のファイルをダウンロードする方法を指定します。 ファイルの種類がわからない場合、または複数のファイルをダウンロードする場合は、[自動] を選択して、オプションで指定された転送ルールに従います |
If file exists | N/A | 上書き、ダウンロードしない、一意の名前でダウンロードする | 上書きする | ファイルが既に存在する場合の処理を指定します。 [上書きする] は、元のファイルに上書きするため、それ以降アクセスできなくなります。[一意の名前でダウンロードする] は、末尾にアンダースコアと連番を追加します |
生成された変数
このアクションは変数を生成しません。
例外
例外 | Description |
---|---|
未接続エラー | FTP サーバーの開いている接続がないことを示します |
「ファイルが見つかりませんでした」エラー | ファイルが見つからなかったことを示します |
FTP 接続の中止エラー | FTP 接続が中止されたことを示します |
ファイルのアップロード エラー | ファイルをアップロードできなかったことを示します |
フォルダーを FTP にアップロード
1 つまたは複数のフォルダーを FTP サーバーにアップロードします。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
Folder(s) to upload | いいえ | フォルダー のリスト | アップロードするフォルダーです。 アップロードするフォルダーは、FTP サーバーのアクティブなディレクトリ内に既に存在していてはなりません | |
Remote location | いいえ | テキスト値 | フォルダーをアップロードする場所 |
生成された変数
このアクションは変数を生成しません。
例外
例外 | Description |
---|---|
未接続エラー | FTP サーバーの開いている接続がないことを示します |
「リモート ディレクトリが存在しません」エラー | ディレクトリが FTP サーバー上に存在しないことを示します |
FTP 接続の中止エラー | FTP 接続が中止されたことを示します |
ディレクトリのアップロード エラー | ディレクトリをアップロードできなかったことを示します |
FTP ファイルを削除
1 つまたは複数のファイルを FTP サーバーから削除します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
削除するファイル | いいえ | FTP ファイル のリスト | 削除するファイル |
生成された変数
このアクションは変数を生成しません。
例外
例外 | Description |
---|---|
未接続エラー | FTP サーバーの開いている接続がないことを示します |
「ファイルが見つかりませんでした」エラー | ファイルが見つからなかったことを示します |
ファイルの削除不可エラー | ファイルの削除を実行できなかったことを示します |
FTP ファイルの名前を変更する
FTP サーバー上にあるファイルの名前を変更します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
名前を変更するファイル | いいえ | FTP ファイル | 名前を変更するファイル | |
新しいファイル名 | いいえ | テキスト値 | ファイルの新しい名前です。 パス付きの名前を入力すると、ファイルがその場所に移動します。 場所が存在しない場合、例外がスローされます |
生成された変数
このアクションは変数を生成しません。
例外
例外 | Description |
---|---|
未接続エラー | FTP サーバーの開いている接続がないことを示します |
ファイルの名前変更不可エラー | ファイルの名前を変更できなかったことを示します |
「ファイルが見つかりませんでした」エラー | ファイルが見つからなかったことを示します |
FTP ディレクトリの作成
FTP サーバーにディレクトリを作成します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
New directory | いいえ | FTP ディレクトリ | 新しいディレクトリです。 パスを指定すると、新しいディレクトリにつながるすべての新しいフォルダが作成されます |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
アクセス拒否エラー | このアカウントが操作に対するアクセス権を持っていないことを示します |
ファイルの存在エラー | ファイルが既に存在することを示します |
ディレクトリの作成エラー | ディレクトリを作成できなかったことを示します |
「ディレクトリが存在しません」エラー | ディレクトリが見つからなかったことを示します |
未接続エラー | FTP サーバーの開いている接続がないことを示します |
FTP ディレクトリを削除
FTP サーバーからディレクトリを削除します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
Directory to delete | いいえ | FTP ディレクトリ | 削除するフォルダーです。 フォルダ内のすべてが削除されます |
生成された変数
このアクションは変数を生成しません。
例外
例外 | 説明設定 |
---|---|
ディレクトリの削除エラー | ディレクトリを削除できなかったことを示します |
「リモート ディレクトリが存在しません」エラー | ディレクトリが FTP サーバー上に存在しないことを示します |
作業ディレクトリの変更エラー | 作業ディレクトリを変更できなかったことを示します |
未接続エラー | FTP サーバーの開いている接続がないことを示します |
FTP コマンドの呼び出し
サーバー上で指定されたリテラル FTP コマンドを呼び出します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
FTP command | いいえ | テキスト値 | 引数を指定して実行するコマンドです。 たとえば、FEAT を実行したり、CHMOD を実行したりすることができます | |
Valid reply code(s) | はい | テキスト値 | コマンドから返される可能性のあるコードをセミコロンで区切って表示します。 FTPコマンドがここに入力されていないコードを返した場合、このアクションは例外をスローします。 単純な FTP、または FTPS 接続でのみ適用されます |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
ReplyCode | Text 値 | 返された実際のコードです。 単純な FTP、または FTPS 接続でのみ適用されます |
ReplyText | テキスト値 | FTP サーバーによって返されるテキスト |
例外
例外 | Description |
---|---|
コマンドの呼び出しエラー | FTP コマンドの呼び出し中にエラーが発生したことを示します |
未接続エラー | FTP サーバーの開いている接続がないことを示します |
ディレクトリの同期
指定したフォルダーのファイルとサブディレクトリを特定のリモート FTP ディレクトリと同期します。
入力パラメーター
引数 | オプション | 受入 | Default Value | 説明設定 |
---|---|---|---|---|
FTP connection | いいえ | FTP 接続 | 作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります | |
Synchronization direction | N/A | リモート -> ローカル (ダウンロード)、ローカル -> リモート (アップロード) | リモート -> ローカル (ダウンロード) | 同期化メソッドの方向です。 ローカル フォルダーをリモート ディレクトリに同期させるか (DOWNLOAD)、リモート ディレクトリをローカル フォルダに同期させるか (UPLOAD) を選択します |
Files to sync | N/A | すべてのファイル、ファイル フィルターに一致するファイルのみ、ファイル フィルターに一致しないファイルのみ | すべてのファイル | すべてのファイルを同期するか、ファイル フィルターを使って特定のファイルのセットを追加または除外するかを選択します |
File filter | いいえ | テキスト値 | * | どのファイルを含め、除外するかを制御するファイル名パターン。 このオプションでは、".txt" , "document?.doc" などのワイルドカードを使用することができます。このオプションでは、コマを区切り文字として使用して複数のフィルタを設定することもできます (例 : ".txt,*.pdf,document?")。 |
Local folder | いいえ | フォルダー | 同期するローカル フォルダーの名前 | |
FTP directory | はい | FTP ディレクトリ | / | 同期する FTP ディレクトリの名前 |
Delete if source is absent | N/A | ブール値 | False | このオプションを選択すると、ソースではなくターゲット ディレクトリに存在するファイルまたはフォルダーが削除されます。 |
Include subdirectories | N/A | ブール値 | 有効 | このオプションを選択すると、同期プロセスにサブディレクトリが含められます。 |
Time difference in hours | はい | 数値 | 0 | リモート サーバーが別のタイム ゾーンで稼働している場合の時差 (時間単位) です。 |
Time difference in minutes | はい | 数値 | 0 | リモート サーバーが別のタイム ゾーンで稼働している場合の時差 (分単位) です。 |
Time difference ahead | N/A | ブール値 | 有効 | サーバーのタイム ゾーンが先行しているかどうかを指定します。 |
生成された変数
引数 | タイプ | 説明設定 |
---|---|---|
FtpFilesAdded | FTP ファイル のリスト | 最初はソースに存在し、同期プロセス後にターゲットに追加された FTP ファイルの一覧です。 |
FtpFilesModified | FTP ファイル のリスト | 最初はソースとターゲットの両方に存在し、同期プロセス後にターゲットに追加された FTP ファイルの一覧です。 |
FtpFilesDeleted | FTP ファイル のリスト | 最初はターゲット ディレクトリに存在し、同期プロセス後に削除された FTP ファイルの一覧です。 |
FilesAdded | ファイル の リスト | 最初はソースに存在し、同期プロセス後にターゲットに追加されたファイルの一覧です。 |
FilesModified | ファイル の リスト | 最初はソースとターゲットの両方に存在し、同期プロセス後にターゲットに追加されたファイルの一覧です。 |
FilesDeleted | ファイル の リスト | 最初はターゲット ディレクトリに存在し、同期プロセス後に削除されたファイルの一覧です。 |
例外
例外 | Description |
---|---|
一覧表示エラー | フォルダーの一覧表示を実行できなかったことを示します |
未接続エラー | FTP サーバーの開いている接続がないことを示します |
「ファイルが見つかりませんでした」エラー | ファイルが見つからなかったことを示します |
FTP 接続の中止エラー | FTP 接続が中止されたことを示します |
ファイルのアップロード エラー | ファイルをアップロードできなかったことを示します |
「リモート ファイルが存在しません」エラー | ファイルが FTP サーバー上に存在しないことを示します |
ファイルのダウンロード不可エラー | ファイルをダウンロードできなかったことを示します |
ディレクトリの削除エラー | ディレクトリを削除できなかったことを示します |
同期失敗エラー | 予期しないエラーによって同期プロセスが失敗したことを示します。 |