Windowsコマンドプロンプトで特定のURLからファイルをダウンロードする方法

Windowsのコマンドプロンプトを使って、特定のURLからファイルを効率よくダウンロードする方法を詳しく説明します。本記事では、cURLのインストールから実際のダウンロード手順、PowerShellを使った方法までを網羅的に解説します。これにより、初心者から上級者まで、ファイルダウンロードに関する知識を深めることができるでしょう。

まず使うコマンド：Windows標準のcurl.exe

Windows 10 1803以降やWindows 11では、まず同梱のcurl.exeを確認します。通常は追加インストール不要です。以下はコマンドプロンプト用の例です。URLは実在する配布元のHTTPS URLへ置き換え、保存先に同名の重要ファイルがないことを確認してください。

curl.exe --version
curl.exe --fail --location --output "file.zip" "https://example.com/file.zip"
echo %ERRORLEVEL%

–failはHTTPエラーを失敗として扱い、–locationはリダイレクトを追跡します。終了コード0でもログイン画面が保存される場合があるため、ファイル形式・サイズや配布元のハッシュも確認します。ダウンロードしたスクリプトや実行ファイルを自動実行しないでください。証明書エラーを–insecureで回避する方法は勧めません。

PowerShellではcurlが別コマンドの別名になっている環境があるため、curl.exeと明記します。Invoke-WebRequestの例はPowerShell内で実行し、CMDへそのまま貼り付けるものではありません。

コマンドプロンプトの基本操作

コマンドプロンプトは、Windowsの主要なコマンドラインインターフェースであり、さまざまなシステム操作をテキストベースで行うことができます。まずは、基本的な操作方法を理解しましょう。

コマンドプロンプトの起動方法

1. スタートメニューを開く
2. 検索ボックスに「cmd」と入力し、「コマンドプロンプト」を選択する

基本的なコマンド

• dir: ディレクトリの内容を一覧表示

  dir

• cd: ディレクトリを変更

  cd ディレクトリ名

• mkdir: 新しいディレクトリを作成

  mkdir 新しいディレクトリ名

• del: ファイルを削除

  del ファイル名

コマンドの実行方法

コマンドプロンプトにコマンドを入力し、Enterキーを押すと、そのコマンドが実行されます。例えば、現在のディレクトリの内容を表示するには、「dir」と入力してEnterキーを押します。

これらの基本操作を理解することで、次のステップで紹介するファイルダウンロードに必要なコマンドの実行が容易になります。

ダウンロードに必要なコマンドの紹介

ファイルをダウンロードするためには、いくつかの基本的なコマンドとツールを理解しておく必要があります。ここでは、最も一般的なコマンドを紹介します。

cURLコマンド

cURL（カール）は、データをURLから転送するためのコマンドラインツールです。Windowsでも使用でき、ファイルのダウンロードやアップロードに非常に便利です。

• ダウンロードの基本コマンド

  curl.exe --fail --location -O [URL]

例:

  curl.exe --fail --location -O https://example.com/file.zip

PowerShellのInvoke-WebRequestコマンド

PowerShellには、Webからのデータ取得に特化したInvoke-WebRequestというコマンドがあります。このコマンドを使うことで、スクリプト内で簡単にファイルをダウンロードできます。

• ダウンロードの基本コマンド

  Invoke-WebRequest -UseBasicParsing -ErrorAction Stop -Uri [URL] -OutFile [保存先のパス]

例:

  Invoke-WebRequest -UseBasicParsing -ErrorAction Stop -Uri https://example.com/file.zip -OutFile C:\path\to\save\file.zip

Bitsadminコマンド

bitsadminは、バックグラウンドでファイルをダウンロードするためのWindowsのコマンドラインツールです。大きなファイルのダウンロードに適しています。

• ダウンロードの基本コマンド

  bitsadmin /transfer myDownloadJob /download /priority normal [URL] [保存先のパス]

例:

  bitsadmin /transfer myDownloadJob /download /priority normal https://example.com/file.zip C:\path\to\save\file.zip

これらのコマンドを使い分けることで、さまざまな状況に応じたファイルダウンロードが可能になります。次に、cURLのインストールと設定方法を解説します。

cURLのインストールと設定

以下の追加インストールは、curl.exe –versionで同梱版が使えない場合や、特定の機能が必要な場合だけ検討します。利用できる環境でPATHを変更して別版へ置き換える必要はありません。

cURLのインストール

1. 公式サイトからダウンロード
2. cURLの公式サイト（https://curl.se/windows/）にアクセスします。
3. 最新のcURLバイナリをダウンロードします。
4. ファイルの解凍
5. ダウンロードしたZIPファイルを適当なフォルダに解凍します。
6. 解凍されたフォルダ内に、curl.exeが含まれていることを確認します。
7. システム環境変数の設定
8. curl.exeのパスをシステムの環境変数に追加します。
9. 「システムのプロパティ」を開き、「環境変数」をクリックします。
10. 「システム環境変数」の「Path」を選択し、「編集」をクリックします。
11. 「新規」をクリックし、curl.exeが含まれるフォルダのパスを追加します。
12. 「OK」をクリックして設定を保存します。

cURLの動作確認

環境変数の設定が完了したら、cURLが正しくインストールされているかを確認します。

1. コマンドプロンプトを開きます。
2. 次のコマンドを入力し、Enterキーを押します。

   curl.exe --version

3. cURLのバージョン情報が表示されれば、インストールは成功です。

プロキシ設定（必要な場合）

プロキシ環境下でcURLを使用する場合、以下の設定が必要です。

1. 環境変数にプロキシ情報を追加します。

   set http_proxy=http://[プロキシサーバー]:[ポート]
   set https_proxy=https://[プロキシサーバー]:[ポート]

2. 上記のコマンドを実行して、プロキシを設定します。

これで、cURLのインストールと基本設定は完了です。次に、cURLを使って実際にファイルをダウンロードする方法について説明します。

cURLを使ったダウンロード方法

cURLのインストールが完了したら、次はcURLを使って特定のURLからファイルをダウンロードする方法について詳しく説明します。

基本的なダウンロードコマンド

cURLでファイルをダウンロードする基本的なコマンドは次の通りです。

curl.exe --fail --location -O [URL]

例:

curl.exe --fail --location -O https://example.com/file.zip

このコマンドは、指定したURLからファイルをダウンロードし、同じ名前で現在のディレクトリに保存します。

ファイル名を指定してダウンロード

ダウンロードするファイルの名前を指定する場合は、-oオプションを使用します。

curl.exe --fail --location -o [保存するファイル名] [URL]

例:

curl.exe --fail --location -o myfile.zip https://example.com/file.zip

このコマンドは、file.zipをmyfile.zipという名前で保存します。

リジューム機能を使ったダウンロード

途中でダウンロードが中断された場合に再開するには、-C -オプションを使用します。

curl.exe --fail --location -C - -O [URL]

例:

curl.exe --fail --location -C - -O https://example.com/largefile.zip

再開にはサーバーのRange対応などの条件があります。同じ内容の部分ファイルであることを確認し、未対応なら別名で最初から取得します。

HTTPSサイトからのダウンロード

HTTPSプロトコルを使用してファイルをダウンロードする場合、追加の設定は不要です。cURLは自動的にHTTPSを処理します。

curl.exe --fail --location -O https://example.com/securefile.zip

認証が必要なサイトからのダウンロード

ユーザー名とパスワードによる認証に対応するHTTPSサイトでは、-uにユーザー名だけ指定してパスワードを対話入力します。履歴やスクリプトにパスワードを直書きしないでください。ブラウザーのSSOやMFAを同じ方法で代替できるとは限りません。

curl.exe --fail --location -u "[ユーザー名]" -O [URL]

例:

curl.exe --fail --location -u "user" -O https://example.com/protectedfile.zip

複数のファイルを一度にダウンロード

複数のファイルを一度にダウンロードする場合は、URLを続けて入力します。

curl.exe --fail --location -O [URL1] -O [URL2] -O [URL3]

例:

curl.exe --fail --location -O https://example.com/file1.zip -O https://example.com/file2.zip -O https://example.com/file3.zip

これらの方法を使うことで、cURLを利用したファイルダウンロードの操作が簡単に行えます。次に、PowerShellを使ったファイルダウンロード方法について説明します。

PowerShellの利用

PowerShellは、Windowsの高度なスcripting環境であり、ファイルのダウンロードにも非常に便利です。ここでは、PowerShellを使って特定のURLからファイルをダウンロードする方法を説明します。

Invoke-WebRequestコマンドを使用したダウンロード

PowerShellでファイルをダウンロードする最も簡単な方法は、Invoke-WebRequestコマンドを使用することです。このコマンドは、指定したURLからデータを取得し、ファイルとして保存することができます。

基本的なコマンド

Invoke-WebRequest -UseBasicParsing -ErrorAction Stop -Uri [URL] -OutFile [保存先のパス]

例:

Invoke-WebRequest -UseBasicParsing -ErrorAction Stop -Uri https://example.com/file.zip -OutFile C:\path\to\save\file.zip

このコマンドは、指定したURLからファイルをダウンロードし、指定したパスに保存します。

認証が必要な場合のPowerShell例

以下はWindows PowerShell 5.1で、認証方式が対応するHTTPS配布元へアクセスする例です。資格情報は対話入力し、ファイルへ保存しません。保存先フォルダーはあらかじめ用意します。

$credential = Get-Credential
Invoke-WebRequest -UseBasicParsing -ErrorAction Stop -Uri "https://example.com/protectedfile.zip" -Credential $credential -OutFile "C:\path\to\save\file.zip"

Windows PowerShell 5.1では-UseBasicParsingを指定してページのスクリプト処理を避けます。PowerShell 7では基本解析が標準です。組織のSSO・MFA方式によってはこの例で認証できません。

エラーハンドリング

ダウンロード中にエラーが発生した場合の対処方法も説明します。PowerShellでは、Try-Catchブロックを使用してエラーを処理できます。

基本的な使用方法

try {
    Invoke-WebRequest -UseBasicParsing -ErrorAction Stop -Uri [URL] -OutFile [保存先のパス]
} catch {
    Write-Error "ダウンロード中にエラーが発生しました: $_"
}

例:

try {
    Invoke-WebRequest -UseBasicParsing -ErrorAction Stop -Uri https://example.com/file.zip -OutFile C:\path\to\save\file.zip
} catch {
    Write-Error "ダウンロード中にエラーが発生しました: $_"
}

これらの方法を使用することで、PowerShellを活用したファイルダウンロードが容易に行えるようになります。次に、応用例としてバッチファイルでの自動ダウンロード方法について説明します。

応用例：バッチファイルでの自動ダウンロード

CMDのバッチでは転送直後に終了コードを確認します。次は3ファイルのうち一つでも失敗したら終了し、全件成功時だけ完了表示する例です。example.comは説明用URLで、実ファイルを提供するものではありません。

@echo off
setlocal
set "SAVE_DIR=%USERPROFILE%\Downloads"
if not exist "%SAVE_DIR%\" exit /b 1
for %%N in (1 2 3) do (
  curl.exe --fail --location --output "%SAVE_DIR%\file%%N.zip" "https://example.com/file%%N.zip"
  if errorlevel 1 exit /b 1
)
echo 全件の転送が成功しました。
exit /b 0

失敗時には途中までのファイルが残ることがあります。ファイルの存在だけで完了扱いにせず、転送成功と内容の検証を分けてください。既存ファイルを上書きしない保存先・命名規則も決めます。

定期実行する前の確認

タスクスケジューラでは実行アカウント、保存先、ネットワークとプロキシ、ログ、終了コードを確認します。対話パスワード入力が必要な例を、そのまま無人実行へ移さないでください。試験用の小さなファイルで成功と失敗の両方を確認してから運用します。

エラー処理とトラブルシューティング

ファイルのダウンロード中にエラーが発生することがあります。ここでは、一般的なエラーとその対処方法について説明します。

cURLのエラー処理

cURLを使用する際に発生する可能性のある一般的なエラーとその対処方法を紹介します。

ネットワークエラー

ネットワーク接続の問題でダウンロードが失敗することがあります。

curl: (6) Could not resolve host: example.com

対処方法:

• インターネット接続を確認します。
• DNS設定を確認し、正しいサーバーを使用していることを確認します。

URLの誤り

対象が存在しない場合などはHTTP 404になります。curlの終了コード22として検出するには–failなどが必要です。URLだけでなく、移動・削除・認証の要否も確認します。

curl: (22) The requested URL returned error: 404 Not Found

対処方法:

• URLが正しいことを確認します。
• リンク先が有効であることを確認します。

権限エラー

認証が必要なサイトにアクセスする際に権限エラーが発生することがあります。

HTTP 401: 認証が必要、または認証情報が受け入れられていない
HTTP 403: サーバーがアクセスを拒否
curl終了コード7: ホストまたはプロキシへの接続失敗（認証失敗とは別）

対処方法:

• 正しい認証情報を使用していることを確認します。
• 必要に応じて、-uオプションでユーザー名とパスワードを指定します。

PowerShellのエラー処理

PowerShellでのダウンロード中に発生するエラーとその対処方法を紹介します。

コマンド実行エラー

PowerShellスクリプトの実行時にエラーが発生した場合の対処方法です。

Invoke-WebRequest : The remote name could not be resolved: 'example.com'

対処方法:

• インターネット接続を確認します。
• URLが正しいことを確認します。

権限エラー

ファイルを保存する際の権限エラーが発生することがあります。

Access to the path 'C:\path\to\save\file.zip' is denied.

対処方法:

• 保存先のディレクトリに書き込み権限があることを確認します。
• まず自分に書き込み権限がある保存先を選びます。ダウンロードだけのために管理者権限へ上げる必要は通常ありません。

一般的な例外処理

PowerShellでは、Try-Catchブロックを使用して一般的な例外を処理できます。

try {
    Invoke-WebRequest -UseBasicParsing -ErrorAction Stop -Uri https://example.com/file.zip -OutFile C:\path\to\save\file.zip
} catch {
    Write-Error "ダウンロード中にエラーが発生しました: $_"
}

このスクリプトは、エラーが発生した場合にエラーメッセージを表示します。

Bitsadminのエラー処理

bitsadminを使用する際に発生するエラーとその対処方法です。

ジョブの作成エラー

ジョブの作成に失敗する場合があります。

BITSADMIN version 3.0
BITS administration utility.
(C) Copyright Microsoft Corp.

Unable to add file - 0x80070002
The system cannot find the file specified.

対処方法:

• ファイルのパスとURLが正しいことを確認します。
• ジョブ名がユニークであることを確認します。

ジョブのステータス確認

ジョブのステータスを確認し、エラーが発生していないか確認します。

bitsadmin /list /allusers

このコマンドで、現在のジョブの状態を確認できます。

これらのエラー処理とトラブルシューティング方法を理解することで、ダウンロードプロセス中に発生する問題に迅速に対処できるようになります。次に、記事全体のまとめを行います。

まとめ

本記事では、Windowsコマンドプロンプトを使って特定のURLからファイルをダウンロードする方法について詳しく解説しました。以下が主なポイントです。

• コマンドプロンプトの基本操作: コマンドプロンプトの起動方法や基本的なコマンドの使い方を紹介しました。
• 必要なコマンドの紹介: ファイルをダウンロードするために使用するcURL、PowerShell、Bitsadminなどのコマンドについて説明しました。
• cURLのインストールと設定: cURLのダウンロード、インストール、環境変数の設定方法を解説しました。
• cURLを使ったダウンロード方法: cURLを使ってファイルをダウンロードする具体的なコマンドとオプションについて紹介しました。
• PowerShellの利用: PowerShellを使ったファイルのダウンロード方法、特にInvoke-WebRequestコマンドの使用方法を詳しく説明しました。
• バッチファイルでの自動ダウンロード: バッチファイルを作成して、複数のファイルを自動的にダウンロードする方法を紹介しました。
• エラー処理とトラブルシューティング: ダウンロード中に発生する可能性のあるエラーとその対処方法について説明しました。

これらの知識を活用して、効率的にファイルをダウンロードし、業務をスムーズに進めることができるでしょう。さらに深い理解や応用が必要な場合は、公式ドキュメントや専門書籍を参考にしてください。

公式資料：curlのオプション・終了コード、Windows PowerShell 5.1 Invoke-WebRequest。