はい、承知いたしました。PowerShellでwgetの代わりにInvoke-WebRequestを使用したい方向けに、詳細な解説を含む約5000語の記事を作成します。記事内容を直接表示します。

PowerShellでwgetしたい人必見！Invoke-WebRequest入門ガイド

はじめに：`wget`ユーザーのためのPowerShellの代替手段

多くのLinuxやmacOSユーザーにとって、コマンドラインからWebリソースをダウンロードしたり、Webサイトのコンテンツを取得したりする際にまず思い浮かぶツールはwgetやcurlでしょう。これらのツールは非常に強力で柔軟性があり、スクリプトの中でWeb操作を行う際に頻繁に利用されます。

では、Windows環境、特にPowerShellを使用しているユーザーが、これらの強力なコマンドラインWebクライアントと同等の操作を行いたい場合、どうすれば良いでしょうか？ PowerShellには、そのための非常に強力なコマンドレットが標準で用意されています。それが今回ご紹介するInvoke-WebRequestです。

Invoke-WebRequestは、指定したURI（Uniform Resource Identifier）からWebコンテンツを取得するためのコマンドレットです。単にファイルをダウンロードするだけでなく、WebページのHTML構造を解析したり、フォームの送信を行ったり、HTTPヘッダーを詳細に制御したりと、多岐にわたるWeb操作をサポートしています。

この記事は、これまでwgetやcurlを使ってきた経験がある方、あるいはPowerShellを使ってWebリソースを取得したいと考えている初心者の方々を対象としています。Invoke-WebRequestの基本的な使い方から、様々なパラメータを使ったカスタマイズ、取得した結果の扱い方、そしていくつかの応用例まで、詳細かつ体系的に解説していきます。約5000語というボリュームで、このコマンドレットの奥深さを余すことなくお伝えできれば幸いです。

さあ、PowerShellの世界でWebを探索するための強力な一歩を踏み出しましょう！

`wget`とは何か？（簡単に）

Invoke-WebRequestの理解を深めるために、比較対象となるwgetについて簡単に触れておきましょう。

wgetは、GNUプロジェクトが開発した、非対話型のネットワークダウンローダーです。HTTP、HTTPS、FTPプロトコルをサポートしており、コマンドラインからファイルやWebページ全体をダウンロードするのに非常に便利です。再帰的なダウンロード、ダウンロードのレジューム、バックグラウンドでの実行など、多くの高度な機能を備えています。多くのLinuxディストリビューションやmacOSに標準でインストールされているか、容易にインストールできます。

例えば、指定したURLのファイルをダウンロードする最も基本的なコマンドは以下のようになります。

bash wget https://example.com/path/to/file.zip

Webページを取得してHTMLファイルを保存する場合は、以下のようになります。

bash wget https://example.com/index.html

wgetはコマンドラインツールであるため、シェルスクリプトなどと組み合わせて自動化されたダウンロード処理などに広く利用されています。

PowerShellにおける`wget`の代替：`Invoke-WebRequest` (iwr)

PowerShellには、wgetやcurlに相当する機能を提供する標準コマンドレットとしてInvoke-WebRequestがあります。このコマンドレットは、HTTP、HTTPS、FTPプロトコルを使用してWebリソースと通信します。

Invoke-WebRequestには、頻繁に入力する手間を省くために、短いエイリアス（別名）が設定されています。それがiwrです。多くのPowerShellユーザーは、Invoke-WebRequestと入力する代わりにiwrを使用します。これはwgetやcurlといった短いコマンド名に慣れているユーザーにとっては非常に親しみやすいでしょう。

例えば、Webページを取得する基本的な操作は、以下のどちらのコマンドでも実行できます。

powershell Invoke-WebRequest -Uri "https://example.com/"

またはエイリアスを使って

powershell iwr -Uri "https://example.com/"

このように、PowerShellにおけるWebリソースの取得や操作は、基本的にInvoke-WebRequestコマンドレットを中心に行われます。単にダウンロードするだけでなく、HTTPメソッドの指定、ヘッダーのカスタマイズ、フォームデータの送信、セッション管理など、Web開発者やシステム管理者が必要とする多くの機能が統合されています。

`Invoke-WebRequest`の基本：最初のステップ

まずはInvoke-WebRequestの最も基本的な使い方から見ていきましょう。指定したURLのコンテンツを取得する操作です。

最もシンプルな使い方：URLを指定してコンテンツを取得

Invoke-WebRequestを使うのに最低限必要なのは、アクセスしたいリソースのURLを指定することです。これには-Uriパラメータを使用します。-Uriパラメータは位置パラメータ（名前を指定せずに値だけを指定できるパラメータ）なので、多くの場合、パラメータ名を省略してURLを直接指定します。

powershell iwr "https://www.microsoft.com/"

このコマンドを実行すると、Microsoftのウェブサイトのトップページにリクエストが送信され、その応答情報がPowerShellのオブジェクトとして返されます。

実行例と出力の解説

上記のコマンドを実行した際の出力は、デフォルトでは以下のような形式になります（出力内容はバージョンや環境によって異なる場合があります）。

StatusCode : 200 StatusDescription : OK Content : <!DOCTYPE html> <html lang="en-US" dir="ltr"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <script type="text/javascript"> //<![CDATA[ var ua = navigator.userAgent.toLowerCase(); ... (ページのHTMLコンテンツの一部) ...

出力されるオブジェクトはMicrosoft.PowerShell.Commands.WebResponseObject型です。このオブジェクトには、Webサーバーからの応答に関する様々な情報が含まれています。主なプロパティをいくつか見てみましょう。

StatusCode: HTTPステータスコードを示します。200は「OK」、つまりリクエストが成功したことを意味します。他にも404（Not Found）、500（Internal Server Error）など、様々なステータスコードがあります。
StatusDescription: ステータスコードに対応する説明です。
Content: 応答の本体（ボディ）です。WebページであればHTMLコンテンツ、テキストファイルであればその内容、JSONデータであればその文字列などが入ります。通常は文字列として扱われますが、バイナリファイルを取得した場合はバイト配列として扱う必要があります。
Headers: 応答ヘッダーの集合です。Content-Type, Server, Date, Set-Cookieなど、サーバーが返した様々なヘッダー情報が含まれています。これはハッシュテーブル（連想配列）として提供されるため、特定のヘッダーの値に簡単にアクセスできます。
RawContent: 応答ヘッダーとコンテンツ全体を含む、生の応答文字列です。デバッグなどで詳細な応答を確認したい場合に便利です。
Forms, Links, Images: これはWindows PowerShell 5.1までのバージョンや、PowerShell 7以降で-UseBasicParsing:$false（デフォルトは$true）を指定しない限り、通常はnullになります。PowerShell 7以降では、HTMLコンテンツの自動解析機能はデフォルトで無効化され、より高速なBasicParsingが使用されます。もしHTML構造を解析したい場合は、HTML解析ライブラリ（例: HtmlAgilityPackをラッパーしたPosh-HTMLなど）を別途利用するか、PowerShell 5.1以前の挙動を再現するために-UseBasicParsing:$false（ただし非推奨）を使う必要があります。ここでは、BasicParsingを前提とした説明を進めます。

HTMLコンテンツの取得と表示

上記の例のように、ContentプロパティにはWebページのHTMLソースコードが含まれています。このHTMLコードをテキストとして確認したい場合、通常はPowerShellのデフォルト出力で十分ですが、特定のプロパティだけを取り出して表示することもできます。

例えば、取得したオブジェクトを変数に格納し、Contentプロパティだけを表示するには以下のようにします。

powershell $response = iwr "https://www.microsoft.com/" $response.Content

これにより、取得したWebページのHTMLソースコード全体がPowerShellコンソールに表示されます。

HTMLの自動解析機能について（注意点）

前述の通り、Invoke-WebRequestは、特にWindows PowerShell 5.1では取得したHTMLコンテンツを自動的に解析し、Forms, Links, Imagesといったプロパティに格納する機能を持っていました。これはHTMLコンテンツから特定の情報を簡単に抽出するのに役立ちました。

“`powershell

Windows PowerShell 5.1の場合、または PowerShell 7+ で -UseBasicParsing:$false を指定した場合 (非推奨)

$response = iwr “https://example.com/” -UseBasicParsing:$false # PowerShell 7+ で旧来の解析を試みる場合
$response.Links.Href # ページ内の全リンクのURLを取得
$response.Forms.Action # ページ内の全フォームのaction属性を取得
“`

しかし、この機能は内部的にInternet Explorerのエンジンを利用しており、パフォーマンスの問題や依存関係の問題がありました。そのため、PowerShell Core (v6以降) および PowerShell 7では、デフォルトの挙動が変更され、この自動解析機能は無効化され、より高速でエンジンに依存しない「BasicParsing」がデフォルトになりました。

PowerShell 7以降でHTML解析を行いたい場合は、先述の通り外部モジュールなどを利用するのが推奨される方法です。

“`powershell

PowerShell 7 以降で HTML を解析する場合（例: Posh-HTML モジュールを使用）

Install-Module Posh-HTML # モジュールがインストールされていない場合

$html = iwr “https://example.com/” | ConvertFrom-Html

$html.Links # リンク情報を取得

“`

本記事では、特に明記しない限り、PowerShell 7以降のデフォルトであるBasicParsingモードを前提とした解説を行います。つまり、Forms, Links, Imagesプロパティは通常使用できない（あるいは内容が期待通りでない）ものとして扱います。

様々なコンテンツタイプの取得と保存

Webから取得できるコンテンツはHTMLだけではありません。テキストファイル、画像、PDF、ZIPファイルなど、様々な種類のファイルをダウンロードしたい場合があります。Invoke-WebRequestはこれらのバイナリファイルやテキストファイルを扱うことも可能です。

バイナリデータの取得と保存 (`-OutFile` パラメータ)

Web上のファイルをダウンロードしてローカルに保存したい場合、-OutFileパラメータを使用します。このパラメータには、保存したいファイルのパスを指定します。

例として、PowerShellのロゴ画像をダウンロードしてみましょう（実際の画像URLは適宜変更してください）。

“`powershell

例: PowerShell ロゴ画像をダウンロード

$imageUrl = “https://learn.microsoft.com/en-us/powershell/media/learn/logo_powershell.svg” # SVG形式の例
$outputPath = “$PSScriptRoot\powershell_logo.svg” # スクリプトが実行されているディレクトリに保存

iwr -Uri $imageUrl -OutFile $outputPath

Write-Host “画像を $outputPath にダウンロードしました。”
“`

このコマンドは、指定したURLからコンテンツを取得し、その内容を-OutFileで指定したパスにファイルとして保存します。Invoke-WebRequestは、取得したコンテンツがテキストかバイナリかを自動的に判別し、適切にファイルに書き込みます。

-OutFileを使用した場合、Invoke-WebRequestコマンドレット自体はファイル保存に成功したかどうかを示すオブジェクトを返しますが、デフォルトではそのオブジェクトは表示されません。成功した場合は特に何も表示されず、エラーが発生した場合にエラーメッセージが表示されます。

大きなファイルをダウンロードする際には、ダウンロードに時間がかかることがあります。残念ながら、Invoke-WebRequest単体には、wgetのようなダウンロード進捗バーを表示する機能は標準ではありません。PowerShell 7以降では-UseBasicParsingがデフォルトになったため、以前のバージョンよりも高速に動作しますが、進捗表示が必要な場合は、別途工夫が必要になる場合があります（例: System.Net.WebClientを利用する、外部ツールを使うなど）。しかし、多くの場合、-OutFileを使ったシンプルなダウンロードで十分です。

`-OutFile`とパイプライン

-OutFileパラメータを指定すると、Invoke-WebRequestは取得したコンテンツを直接ファイルに書き込みます。この場合、通常、コマンドレットはパイプラインにオブジェクトを出力しません（Windows PowerShell 5.1では出力されるオブジェクトが異なりましたが、PowerShell 7以降のBasicParsingでは出力は抑制されます）。

もし、コンテンツを取得した後に、その内容をファイルに保存しつつ、さらに別の処理も行いたいという場合は、-OutFileを使わずにコンテンツを取得し、その内容を変数に格納してから、Set-ContentやOut-Fileコマンドレットを使ってファイルに書き込むという方法が考えられます。ただし、これはバイナリファイルには適しません（バイナリデータが文字列として扱われてしまうため）。バイナリデータを扱う場合は、取得したオブジェクトのContentプロパティ（バイト配列になっている）を適切にファイルに書き込む必要があります。

“`powershell

テキストファイルとして取得し、変数に格納してから保存する場合

$txtUrl = “https://raw.githubusercontent.com/PowerShell/PowerShell/master/README.md”
$response = iwr -Uri $txtUrl
$response.Content | Out-File “$PSScriptRoot\README.md” -Encoding Utf8

Write-Host “テキストファイルをダウンロードし、内容を取得・保存しました。”
“`

バイナリデータを安全に取得して変数に格納し、ファイルに保存するには、もう少し低レベルなAPI (System.Net.WebClientやSystem.Net.Http.HttpClient) を使う方が確実な場合もありますが、単純なダウンロードであれば-OutFileが最も簡単で推奨される方法です。

リクエストのカスタマイズ：思い通りのリクエストを送る

Webサーバーとの通信では、単にURLを指定するだけでなく、リクエストのメソッドを変更したり、特定のヘッダー情報を付加したり、データを送信したりと、様々なカスタマイズが必要になります。Invoke-WebRequestはこれらのニーズに応えるための多くのパラメータを提供しています。

メソッドの指定 (`-Method`)

HTTPリクエストには、GET, POST, HEAD, PUT, DELETEなど、いくつかのメソッドがあります。デフォルトではInvoke-WebRequestはGETメソッドを使用しますが、-Methodパラメータを使って変更できます。

GET: リソースを取得します。最も一般的です。
POST: サーバーにデータを送信し、特定のリソース（例えば、フォームの入力データ）を処理させます。新しいリソースを作成するためにも使われます。
HEAD: GETと似ていますが、応答のヘッダーのみを取得し、応答本体（コンテンツ）は取得しません。リソースの存在確認や更新日時などのメタデータ取得に利用できます。
PUT: 指定したURIにリソースを作成または更新します。
DELETE: 指定したURIのリソースを削除します。

例えば、特定のURLに対してHEADリクエストを送信して、応答ヘッダーのみを確認したい場合は以下のようになります。

powershell iwr -Uri "https://example.com/" -Method HEAD

このコマンドの出力には、Contentプロパティは含まれず、StatusCodeやHeadersなどの情報のみが表示されます。これは、リソースの内容を取得する必要がない場合に帯域幅や処理時間を節約するのに役立ちます。

POSTメソッドを使ってWeb APIにデータを送信するような例は、後述の「応用例」セクションで詳しく解説します。

ヘッダーの追加・変更 (`-Headers`)

HTTPリクエストには、User-Agent, Referer, Cookie, Authorizationなど、様々なヘッダー情報を含めることができます。サーバーはこれらのヘッダーを基にリクエストを処理したり、適切な応答を返したりします。Invoke-WebRequestでは、-Headersパラメータを使って独自のリクエストヘッダーを追加したり、デフォルトのヘッダーを上書きしたりできます。

-Headersパラメータには、ヘッダー名と値のペアを格納したハッシュテーブル（連想配列）を指定します。

“`powershell

例: User-Agent ヘッダーを変更する

$headers = @{
“User-Agent” = “Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.127 Safari/537.36”
“Accept-Language” = “ja,en-US;q=0.9,en;q=0.8”
}

iwr -Uri “https://www.google.com/” -Headers $headers
“`

デフォルトでは、Invoke-WebRequestは自身の情報（PowerShellのバージョンなど）を含むUser-Agentヘッダーを送信します。しかし、一部のWebサイトやAPIは特定のUser-Agentを期待したり、自動化されたリクエストをブロックしたりすることがあります。そのような場合、ブラウザのようなUser-Agentを設定することで、問題を回避できることがあります。

他にも、Referer（どのページからリンクをたどって来たかを示す）、Authorization（認証情報）、X-Requested-With（Ajaxリクエストを示す）など、様々なヘッダーを設定することが可能です。

パラメータの送信 (`-Body`)

GETリクエストでクエリパラメータを送信する場合（例: ?query=searchterm&page=2）は、-Uriパラメータに直接クエリ文字列を含めます。

“`powershell

GETリクエストでクエリパラメータを送信

iwr -Uri “https://www.google.com/search?q=PowerShell+Invoke-WebRequest”
“`

POSTリクエストでフォームデータやAPIリクエストのペイロードを送信する場合は、-Bodyパラメータを使用します。-Bodyには、送信したいデータを指定します。データの形式は、送信先のサーバーが期待する形式に合わせる必要があります。

一般的なWebフォームの送信（application/x-www-form-urlencoded形式）の場合、-Bodyにはキーと値のペアをハッシュテーブルとして指定できます。Invoke-WebRequestがこれを適切な形式にエンコードして送信します。

“`powershell

例: 擬似的なログインフォーム送信（POSTリクエスト）

$loginUrl = “https://example.com/login” # 実際のログインURLではない
$formData = @{
“username” = “myuser”
“password” = “mypassword”
“remember_me” = “on”
}

iwr -Uri $loginUrl -Method POST -Body $formData
“`

APIにJSONデータを送信する場合など、ハッシュテーブル形式では対応できない複雑なデータや、特定のコンテンツタイプ（例: application/json）で送信したい場合は、-Bodyに文字列としてペイロード全体を指定し、-HeadersパラメータでContent-Typeヘッダーを適切に設定する必要があります。

“`powershell

例: JSONデータをPOSTリクエストで送信

$apiUrl = “https://example.com/api/users”
$jsonData = @{
“name” = “Taro Yamada”
“email” = “[email protected]”
} | ConvertTo-Json # PowerShellオブジェクトをJSON文字列に変換

$headers = @{
“Content-Type” = “application/json”
“Accept” = “application/json”
}

iwr -Uri $apiUrl -Method POST -Headers $headers -Body $jsonData
“`

バイナリデータをPOSTで送信する場合（例えば、ファイルをアップロードする場合）は、-Bodyパラメータにバイト配列を指定します。ファイルのバイト配列はGet-Content -Encoding Byteなどで取得できます。

“`powershell

例: ファイルをアップロード (multipart/form-data) – これは少し複雑

Invoke-WebRequestで multipart/form-data を扱うのはやや面倒です。

通常は System.Net.Http.HttpClient を使う方が簡単ですが、基本的な考え方として Body にバイト配列を指定できることを示します。

単純なバイナリデータのPOST

$fileBytes = Get-Content -Path “C:\path\to\localfile.bin” -Encoding Byte
iwr -Uri “https://example.com/upload” -Method POST -Body $fileBytes -Headers @{“Content-Type” = “application/octet-stream”}
“`

multipart/form-dataのような複雑な形式でファイルをアップロードする場合は、Invoke-WebRequestの-Bodyパラメータだけでは直接的に対応できません。自分でHTTPリクエストのボディを構築するか、あるいはSystem.Net.Http.HttpClientのようなより低レベルのクラスを利用する必要があります。しかし、多くのAPI連携においては、JSONやapplication/x-www-form-urlencoded形式が使われるため、-BodyパラメータでハッシュテーブルやJSON文字列を指定する方法が役立ちます。

クッキーとセッション管理 (`-SessionVariable`)

Webサイトの中には、ログイン状態を維持したり、ユーザー固有の設定を記憶したりするためにクッキー（Cookie）を使用するところがあります。複数のリクエスト間でクッキー情報を引き継ぎ、同じセッションを維持したい場合、-SessionVariableパラメータが便利です。

-SessionVariableパラメータには、セッション情報を格納するための変数名を指定します。Invoke-WebRequestはこの変数にWebRequestSessionオブジェクトを格納します。このオブジェクトは、クッキー情報などを保持しており、以降のリクエストで同じ-SessionVariableを指定することで、セッションを維持できます。

“`powershell

例: ログインして、ログイン後ページにアクセスする

$loginUrl = “https://example.com/login” # 実際のログインURLではない
$dashboardUrl = “https://example.com/dashboard” # 実際のログイン後URLではない
$username = “myuser”
$password = “mypassword”

セッションを格納する変数名を指定

$sessionName = “MyWebSession”

ログインリクエスト（通常はPOST）

セッション変数に情報を格納

iwr -Uri $loginUrl -Method POST -Body @{ username = $username; password = $password } -SessionVariable $sessionName

ログイン後ページへのアクセス

同じセッション変数を指定して、ログイン時に取得したクッキーを引き継ぐ

$dashboardContent = iwr -Uri $dashboardUrl -SessionVariable $sessionName

Write-Host “ダッシュボードの内容を取得しました:”
$dashboardContent.Content # ログイン後のページコンテンツを表示
“`

このように-SessionVariableを使うことで、ログインが必要なサイトから情報を取得したり、セッション固有の操作を行ったりすることが可能になります。ログイン処理の具体的な方法はサイトによって異なります（フォームデータの形式、リダイレクトの有無など）が、セッション管理の基本的な考え方は同じです。

より高度なクッキー管理が必要な場合（例えば、特定のクッキーだけを操作したい場合など）は、System.Net.CookieContainerクラスを明示的に使用し、それを-WebSessionパラメータに渡す方法もありますが、通常は-SessionVariableで十分です。

タイムアウトの設定 (`-TimeoutSec`)

Webリクエストが完了するまでに時間がかかりすぎる場合、処理を中断したいことがあります。-TimeoutSecパラメータを使うと、リクエストのタイムアウト時間を秒単位で指定できます。

“`powershell

例: タイムアウトを10秒に設定

iwr -Uri “http://slow-responding-site.com/” -TimeoutSec 10
“`

指定した秒数内に応答がない場合、Invoke-WebRequestはエラーを発生させます。デフォルトのタイムアウト時間は環境によって異なりますが、長時間応答がないサイトにアクセスする可能性がある場合は、明示的にタイムアウトを設定しておくことが推奨されます。

認証 (`-Credential`)

HTTP Basic認証やDigest認証など、Webサーバーによっては認証が必要な場合があります。Invoke-WebRequestは-Credentialパラメータを使って資格情報を提供できます。

-Credentialパラメータには、Get-Credentialコマンドレットで取得した資格情報オブジェクト（ユーザー名とパスワード）を指定します。

“`powershell

例: Basic認証が必要なサイトにアクセス

$credential = Get-Credential -Message “Basic認証のユーザー名とパスワードを入力してください”

iwr -Uri “https://auth.example.com/protected-resource” -Credential $credential
“`

Get-Credentialを実行すると、ユーザー名とパスワードの入力ダイアログが表示されます。入力された情報はSecureStringとして格納され、-Credentialパラメータを通じて安全にInvoke-WebRequestに渡されます。

他の認証方式（OAuthなど）が必要な場合は、-Headersパラメータを使って適切なAuthorizationヘッダーを自分で設定する必要があります。

出力の扱い：取得した情報を活用する

Invoke-WebRequestが返すWebResponseObjectオブジェクトには、Webサーバーからの応答に関する様々な情報が含まれています。これらの情報をスクリプトの中で活用するには、オブジェクトのプロパティにアクセスしたり、取得したコンテンツをさらに処理したりする必要があります。

Responseオブジェクトの詳細

前述の通り、Invoke-WebRequestの出力はMicrosoft.PowerShell.Commands.WebResponseObject型のオブジェクトです。このオブジェクトが持つ主なプロパティを改めて確認しましょう。

StatusCode: HTTPステータスコード (例: 200, 404, 500)。リクエストが成功したか、どのような種類のエラーが発生したかなどを判断するのに非常に重要です。
StatusDescription: ステータスコードに対応するテキスト説明 (例: OK, Not Found, Internal Server Error)。
Content: 応答本体。WebページのHTML、APIの応答データ、ファイルの内容など。通常は文字列ですが、バイナリファイルの場合はバイト配列になります。
Headers: 応答ヘッダー。Content-Type, Content-Length, Set-Cookie, Locationなど、サーバーからのメタデータが含まれます。ハッシュテーブル形式なので、$response.Headers."Content-Type"のようにアクセスできます。
RawContent: 応答の全てのヘッダーとボディを含む生の文字列。デバッグや、ヘッダーとボディの境界などを詳細に確認したい場合に役立ちます。
BaseResponse: 基となるSystem.Net.Http.HttpResponseMessageオブジェクト（PowerShell 7以降）またはSystem.Net.WebResponseオブジェクト（Windows PowerShell 5.1）。低レベルなプロパティ（例えば、リダイレクトの追跡情報など）にアクセスしたい場合に利用できます。

特定の情報の抽出

取得したオブジェクトから特定の情報を取り出すには、ドット記法 (.) を使ってプロパティにアクセスします。

“`powershell
$response = iwr “https://httpbin.org/status/404” # 意図的に404を返すURLの例

Write-Host “ステータスコード: $($response.StatusCode)”
Write-Host “ステータス説明: $($response.StatusDescription)”

ヘッダーのContent-Typeを取得

Write-Host “Content-Type: $($response.Headers.”Content-Type”)”

応答本文を取得

$content = $response.Content
Write-Host “応答本文の最初の100文字:”
$content.Substring(0, [Math]::Min(100, $content.Length))
“`

ハッシュテーブルであるHeadersプロパティから特定のヘッダーの値を取得する際には、ヘッダー名にハイフンが含まれている場合など、そのままではプロパティとしてアクセスできないことがあります。そのような場合は、ダブルクォーテーションで囲んで文字列として指定します（例: $response.Headers."Content-Type")。

HTML解析プロパティの利用（PowerShell 5.1 または `-UseBasicParsing:$false` 時）

繰り返しになりますが、PowerShell 5.1や、PowerShell 7以降で-UseBasicParsing:$falseを指定した場合（非推奨）は、Forms, Links, ImagesといったHTML解析済みのプロパティが利用できます。

“`powershell

Windows PowerShell 5.1 もしくは PowerShell 7+ で -UseBasicParsing:$false を指定した場合

$response = iwr “https://example.com/” -UseBasicParsing:$false

ページ内の全リンクのhref属性を取得

$response.Links.Href

ページ内の全フォームのaction属性を取得

$response.Forms.Action

ページ内の全画像のsrc属性とalt属性を取得

$response.Images | Select-Object Src, Alt

“`

これらのプロパティは非常に便利でしたが、PowerShell 7以降では利用できなくなったため、前述の通り外部ライブラリの利用を検討する必要があります。

出力を変数に格納する

Invoke-WebRequestの出力を変数に格納することで、取得した情報を後続の処理で何度でも利用したり、加工したりすることができます。

“`powershell
$webResult = iwr “https://api.github.com/”

変数に格納されたオブジェクトのプロパティにアクセス

Write-Host “GitHub API ステータスコード: $($webResult.StatusCode)”
Write-Host “GitHub API 応答本文:”
$webResult.Content # APIの応答（通常はJSON形式の文字列）
“`

取得したコンテンツがJSONやXML形式の場合、PowerShellにはそれらをPowerShellオブジェクトに変換するコマンドレットがあります。

ConvertFrom-Json: JSON文字列をPowerShellオブジェクト（PSCustomObjectや配列）に変換します。
ConvertFrom-Xml: XML文字列をPowerShellオブジェクトに変換します。

これらのコマンドレットと組み合わせて、APIからの応答データを簡単に操作できます。

“`powershell
$apiResponse = iwr “https://api.github.com/users/PowerShell”
$userData = $apiResponse.Content | ConvertFrom-Json

変換後のPowerShellオブジェクトのプロパティにアクセス

Write-Host “ユーザー名: $($userData.login)”
Write-Host “公開リポジトリ数: $($userData.public_repos)”
Write-Host “フォロワー数: $($userData.followers)”
“`

このように、Invoke-WebRequestで取得した生データを、PowerShellの他のコマンドレットを使って加工・整形することで、様々な自動化処理やデータ分析が可能になります。

エラーハンドリング：問題発生時に適切に対応する

Webリクエストは常に成功するとは限りません。ネットワークの問題、サーバー側のエラー、存在しないURLへのアクセスなど、様々な理由でエラーが発生する可能性があります。スクリプトが予期せず停止するのを防ぎ、問題が発生した場合に適切に対応するためには、エラーハンドリングが重要です。

Invoke-WebRequestで発生する可能性のあるエラーには、主に以下の種類があります。

ネットワークレベルのエラー: サーバーに接続できない、名前解決に失敗するなどのエラー。これはPowerShellの標準的なエラーメカニズム（非終端エラーまたは終端エラー）として報告されます。
HTTPレベルのエラー: サーバーがリクエストを処理したが、エラーを示すHTTPステータスコード（4xxクライアントエラーや5xxサーバーエラー）を返した場合。これはデフォルトでは終端エラーとして扱われ、スクリプトの実行が停止します。

HTTPエラーへの対応 (`-ErrorAction`, `-ErrorVariable`)

デフォルトでは、Invoke-WebRequestは400番台や500番台のHTTPステータスコードを受け取ると終端エラーを発生させます。これにより、スクリプトの実行は即座に停止します。しかし、特定のステータスコード（例えば404 Not Found）を受け取っても処理を続けたい場合があります。

-ErrorActionパラメータを使うと、エラーが発生した場合の挙動を制御できます。

Continue (デフォルト): エラーメッセージを表示して実行を続けます（非終端エラーの場合）。終端エラーの場合は停止します。
SilentlyContinue: エラーメッセージを表示せずに実行を続けます（非終端エラーの場合）。終端エラーの場合は停止します。
Stop: 全てのエラーを終端エラーとして扱い、即座に停止します。
Ignore: エラーを完全に無視します。
Inquire: エラーが発生した場合にユーザーに問い合わせます。

HTTPエラーはデフォルトで終端エラーとして扱われるため、通常のエラーメッセージを表示せずに処理を続けたい場合は、try-catchブロックと組み合わせるか、-ErrorActionをSilentlyContinueやIgnoreなどに設定し、返されるオブジェクトのStatusCodeをチェックする必要があります。

しかし、単純に-ErrorAction SilentlyContinueを使うだけでは、エラーが発生したかどうかを後から判定するのが難しくなります。エラーが発生した場合にエラー情報を変数に格納したい場合は、-ErrorVariableパラメータを使用します。

“`powershell

例: 存在しないURLにアクセスし、エラー情報を取得

$errorVarName = “WebRequestError”
$response = iwr -Uri “https://example.com/nonexistentpage” -ErrorAction SilentlyContinue -ErrorVariable $errorVarName

エラーが発生したかチェック

if ($response -eq $null -or $response.StatusCode -ge 400) {
Write-Host “Webリクエストでエラーが発生しました。”
# -ErrorVariable で指定した変数には、エラー情報が配列として格納される
if ($errorVariable.$errorVarName) {
$errorVariable.$errorVarName | ForEach-Object {
Write-Host ” エラータイプ: $($.CategoryInfo.Reason)”
Write-Host ” エラーメッセージ: $($.Exception.Message)”
# HTTPエラーの場合、Exception に System.Net.WebException が含まれることがある
# WebResponse プロパティから StatusCode などを取得できる場合がある
if ($.Exception.Response -is [System.Net.HttpWebResponse]) {
Write-Host ” HTTPステータスコード: $($.Exception.Response.StatusCode)”
}
}
}
} else {
Write-Host “Webリクエストは成功しました (StatusCode: $($response.StatusCode))”
}
“`

この例では、-ErrorAction SilentlyContinueを指定することで、404エラーが発生してもスクリプトが停止せず、エラー情報が$errorVariable.WebRequestErrorという変数に格納されます。その後、返された$responseオブジェクトがnullかどうか、あるいはStatusCodeが400以上かどうかでエラーを判定しています。

`try-catch`ブロックによるエラーハンドリング

より構造的なエラーハンドリングを行うには、PowerShellのtry-catchブロックを使用するのが最も一般的で推奨される方法です。tryブロック内でエラーが発生した場合、そのエラーをcatchブロックで捕捉して処理を記述できます。HTTPエラーをcatchブロックで捕捉するためには、Invoke-WebRequestはデフォルトで終端エラーを発生させるため、特別な設定は不要です。

“`powershell

例: try-catch ブロックを使ったエラーハンドリング

$uri = “https://example.com/nonexistentpage”

try {
$response = iwr -Uri $uri -TimeoutSec 5 # タイムアウトもtryで捕捉できる

# ステータスコードが成功範囲内かチェック (2xx 以外はエラーとみなす場合)
if ($response.StatusCode -ge 400) {
    Write-Warning "リクエストは成功しましたが、サーバーはエラーコード $($response.StatusCode) を返しました。"
    Write-Warning "ステータス説明: $($response.StatusDescription)"
    # 必要に応じて、ここでさらに処理を中断したり、エラーを再発生させたりする
    # throw "HTTP Error: $($response.StatusCode)"
} else {
    Write-Host "Webリクエストは成功しました (StatusCode: $($response.StatusCode))"
    # 成功時の処理
    Write-Host "コンテンツ長: $($response.Headers.'Content-Length') バイト"
}

} catch {
# エラーが発生した場合の処理
Write-Error “Webリクエスト中に例外が発生しました: $($_.Exception.Message)”

# HTTPエラー (StatusCode >= 400) の場合、Exception.Response から詳細を取得できる
if ($_.Exception.Response -is [System.Net.HttpWebResponse]) {
    $httpErrorResponse = $_.Exception.Response
    Write-Error "  HTTPステータスコード: $($httpErrorResponse.StatusCode)"
    Write-Error "  HTTPステータス説明: $($httpErrorResponse.StatusDescription)"
    # エラー応答のコンテンツを取得したい場合 (注意: 応答本文がない場合もある)
    # try {
    #     $reader = New-Object System.IO.StreamReader($httpErrorResponse.GetResponseStream())
    #     $errorContent = $reader.ReadToEnd()
    #     $reader.Close()
    #     Write-Error "  エラー応答本文: $($errorContent)"
    # } catch {
    #     Write-Error "  エラー応答本文の取得に失敗しました。"
    # }
} elseif ($_.Exception -is [System.Net.WebException]) {
     # ネットワークエラーなど、HTTP以外のWebException
     Write-Error "  ネットワークエラー: $($_.Exception.Status)"
} elseif ($_.Exception -is [System.TimeoutException]) {
     # タイムアウトエラー
     Write-Error "  リクエストがタイムアウトしました。"
}

}
“`

この例では、tryブロック内でInvoke-WebRequestを実行し、ネットワークエラーやタイムアウト、HTTPエラー（400番台、500番台）が発生した場合はcatchブロックで捕捉します。catchブロック内では、$_変数を通じてエラーの詳細情報（例外の種類、メッセージなど）にアクセスできます。特にHTTPエラーの場合は、$_.Exception.ResponseプロパティからSystem.Net.HttpWebResponseオブジェクトを取得し、そのStatusCodeやStatusDescriptionを確認することが可能です。

try-catchブロックを使うことで、エラーの種類に応じて異なる処理を実行したり、エラーメッセージをカスタマイズしたり、エラーログを記録したりといった、より堅牢なスクリプトを作成できます。

応用例：`Invoke-WebRequest`を使いこなす

Invoke-WebRequestは、単なるファイルダウンロードツールにとどまらず、様々な自動化やスクリプト作成に活用できます。いくつかの応用例を見てみましょう。

1. ファイルの自動ダウンロード

定期的に更新されるファイルをWebからダウンロードして保存するタスクはよくあります。-OutFileパラメータを使えば簡単に実現できます。

“`powershell

例: 最新のPowerShellリリースノートをダウンロードする

$releaseNotesUrl = “https://raw.githubusercontent.com/PowerShell/PowerShell/master/CHANGELOG/7.x/7.4.md” # 例として7.4のCHANGELOG
$downloadPath = “$PSScriptRoot\CHANGELOG_7.4.md”

try {
Write-Host “リポジトリから CHANGELOG をダウンロード中…”
iwr -Uri $releaseNotesUrl -OutFile $downloadPath -ErrorAction Stop

Write-Host "ダウンロード完了: $downloadPath"

# ダウンロードしたファイルの内容を確認
# Get-Content $downloadPath

} catch {
Write-Error “ダウンロード中にエラーが発生しました: $($_.Exception.Message)”
}
“`

このスクリプトをタスクスケジューラなどで定期実行させれば、自動的にファイルを更新できます。

2. Web APIの呼び出しとJSON/XMLデータの処理

Web APIは、プログラムがWebサービスと連携するための標準的な手法です。多くのWeb APIはJSONまたはXML形式でデータを提供します。Invoke-WebRequestはこれらのAPIを呼び出し、取得した応答データをPowerShellオブジェクトに変換するのに非常に適しています。

例として、GitHub APIを使ってユーザー情報を取得してみましょう。

“`powershell

例: GitHub APIでユーザー情報を取得する

$githubUser = “PowerShell”
$apiUrl = “https://api.github.com/users/$githubUser”

try {
Write-Host “GitHub APIからユーザー情報を取得中…”
$apiResponse = iwr -Uri $apiUrl -Headers @{“Accept” = “application/vnd.github.v3+json”} -ErrorAction Stop

# 応答本文がJSON形式なので、PowerShellオブジェクトに変換
$userData = $apiResponse.Content | ConvertFrom-Json

Write-Host "--- ユーザー情報 ---"
Write-Host "ログイン名: $($userData.login)"
Write-Host "フルネーム: $($userData.name)"
Write-Host "会社: $($userData.company)"
Write-Host "所在地: $($userData.location)"
Write-Host "公開リポジトリ数: $($userData.public_repos)"
Write-Host "フォロワー数: $($userData.followers)"
Write-Host "アカウント作成日: $($userData.created_at)"
Write-Host "プロフィールURL: $($userData.html_url)"
Write-Host "------------------"

} catch {
Write-Error “GitHub API呼び出し中にエラーが発生しました: $($.Exception.Message)”
if ($.Exception.Response -is [System.Net.HttpWebResponse]) {
Write-Error ” HTTPステータスコード: $($_.Exception.Response.StatusCode)”
}
}
“`

このスクリプトでは、Invoke-WebRequestでAPIエンドポイントにアクセスし、応答本文（JSON文字列）をConvertFrom-JsonコマンドレットでPowerShellオブジェクトに変換しています。変換後のオブジェクトは、通常のPowerShellオブジェクトと同様にプロパティにアクセスして情報を抽出できます。

XML形式のAPI応答を処理する場合は、ConvertFrom-Xmlを使用します。

“`powershell

例: XML形式のAPI応答を処理 (例: Googleの古いSearch APIの形式を模倣)

$xmlApiUrl = “https://example.com/api/data.xml” # 実際のXML APIではない

実際のAPIに合わせて適切に設定

$apiResponse = iwr -Uri $xmlApiUrl -Headers @{“Accept” = “application/xml”} -ErrorAction Stop

応答本文がXML形式の場合

$xmlData = $apiResponse.Content | ConvertFrom-Xml

変換後のPowerShellオブジェクトからデータにアクセス

$xmlData.RootElement.ChildElement.Property

“`

APIによっては、POSTメソッドでデータを送信する必要があります。その場合は、先述の-Method POSTと-Bodyパラメータを組み合わせて使用します。-Bodyには、APIが期待する形式（JSON文字列、フォームデータなど）でデータを指定します。

3. Webサイトのステータスチェック

Webサイトが正常に稼働しているか（応答があるか、特定のステータスコードを返しているか）をチェックするスクリプトを作成できます。

“`powershell

例: 複数のWebサイトのステータスをチェックする

$websites = @(
“https://www.google.com”
“https://www.microsoft.com”
“https://www.nonexistentwebsite12345.com” # 存在しないサイトの例
“https://httpbin.org/status/503” # 意図的に503を返すURLの例
)

foreach ($uri in $websites) {
Write-Host “checking $uri …”
try {
# HEADリクエストで応答ヘッダーのみを取得 (コンテンツは不要なので高速)
# ただし、一部のサーバーはHEADリクエストをサポートしていない場合があるため、GETを使うのが安全な場合も
# GETの場合はタイムアウトを短めに設定する
$response = iwr -Uri $uri -Method GET -TimeoutSec 10 -ErrorAction Stop

    # 200番台のステータスコードを成功とみなす
    if ($response.StatusCode -ge 200 -and $response.StatusCode -lt 300) {
        Write-Host "  Success! Status Code: $($response.StatusCode) $($response.StatusDescription)" -ForegroundColor Green
    } elseif ($response.StatusCode -ge 300 -and $response.StatusCode -lt 400) {
         Write-Host "  Redirect. Status Code: $($response.StatusCode) $($response.StatusDescription). Location: $($response.Headers.Location)" -ForegroundColor Yellow
    } else {
        Write-Host "  Error! Status Code: $($response.StatusCode) $($response.StatusDescription)" -ForegroundColor Red
    }

} catch {
    # ネットワークエラーやタイムアウトなどの終端エラー
    Write-Host "  Error! Exception: $($_.Exception.Message)" -ForegroundColor Red

    # HTTPエラーでStatusCodeが取得可能な場合
    if ($_.Exception.Response -is [System.Net.HttpWebResponse]) {
         $httpErrorResponse = $_.Exception.Response
         Write-Host "  HTTP Status Code (from exception): $($httpErrorResponse.StatusCode) $($httpErrorResponse.StatusDescription)" -ForegroundColor Red
    }
}
Write-Host "" # 空行を追加

}
“`

このスクリプトは、リストアップした各URLに対してGETリクエストを送信し、取得したステータスコードに基づいて結果を表示します。try-catchブロックを使って、ネットワークエラーなども適切に捕捉しています。HEADメソッドはコンテンツを取得しないため、GETよりも高速で帯域幅を節約できますが、一部のサーバーではサポートされていないため、GETを使う方がより広範なサイトに対応できます。この例では、GETメソッドを使用し、タイムアウトを短めに設定することで、応答がない場合にも素早くエラーを検出できるようにしています。

4. Webサイトからの情報抽出（簡易スクレイピング）

Invoke-WebRequestは、WebページのHTMLを取得できます。取得したHTMLから特定の情報を抽出する（簡易的なスクレイピング）ことも可能です。ただし、複雑なHTML解析やJavaScriptで動的に生成されるコンテンツの取得には、Invoke-WebRequest単体では限界があります。より高度なスクレイピングには、SeleniumやPuppeteerのようなブラウザ自動操作ツールや、HtmlAgilityPackのような専門的なHTML解析ライブラリと組み合わせる必要があります。

ここでは、取得したHTML文字列に対して正規表現などを使って簡単な情報を抽出する例を示します。

“`powershell

例: Webページのタイトルタグの内容を抽出する

$url = “https://learn.microsoft.com/ja-jp/powershell/”

try {
$response = iwr -Uri $url -ErrorAction Stop

# Content プロパティにはページのHTMLが格納されている
$htmlContent = $response.Content

# 正規表現を使って <title>...</title> の内容を抽出
# 正規表現パターン: <title>(.*?)</title>
# (.*?) は非貪欲マッチで、<title> と </title> の間の任意の文字列にマッチ
$titleMatch = [regex]::Match($htmlContent, '<title>(.*?)</title>', [System.Text.RegularExpressions.RegexOptions]::IgnoreCase)

if ($titleMatch.Success) {
    $pageTitle = $titleMatch.Groups[1].Value
    Write-Host "ページのタイトル: $pageTitle"
} else {
    Write-Host "タイトルタグが見つかりませんでした。"
}

} catch {
Write-Error “ページの取得または解析中にエラーが発生しました: $($_.Exception.Message)”
}
“`

この例では、取得したHTML文字列に対して正規表現を適用し、<title>タグの内容を抽出しています。これは非常に単純な例ですが、特定のパターンを持つ情報を抽出する場合には有効です。

より複雑なHTML構造から要素を抽出したい場合は、PowerShell 5.1のHTML解析機能（非推奨）を使うか、あるいは.NETのHtmlAgilityPackのようなライブラリをPowerShellから利用することを検討してください。Posh-HTMLモジュールはHtmlAgilityPackをラップしており、PowerShell 7以降でもXPathなどを使ったHTML要素の抽出を比較的簡単に行えます。

`Invoke-RestMethod`との違い

PowerShellにはInvoke-WebRequestと非常によく似たコマンドレットにInvoke-RestMethod（エイリアス: irm）があります。これらのコマンドレットはどちらもWebリソースへのリクエストを送信しますが、主な違いは「応答をどのように扱うか」という点にあります。

Invoke-WebRequest: Webサーバーからの生の応答（HTTPステータス、ヘッダー、コンテンツ）を詳細なオブジェクト（WebResponseObject）として返します。コンテンツは通常、単なる文字列またはバイト配列として提供されます。WebページのHTMLを取得してその構造を解析したり、ヘッダー情報を細かく確認したり、バイナリファイルをダウンロードしたりするのに適しています。
Invoke-RestMethod: Webサーバーからの応答を、そのコンテンツタイプに基づいて自動的にPowerShellオブジェクトに変換しようとします。例えば、応答がJSON形式であればPowerShellオブジェクト（PSCustomObjectや配列）に、XML形式であればXMLオブジェクトに、RSS/Atomフィードであればフィードオブジェクトに変換します。主にRESTful APIを呼び出して、構造化されたデータ（JSONやXML）を扱うのに適しています。

簡単な比較例：

“`powershell

GitHub APIへのアクセス例

$apiUrl = “https://api.github.com/users/PowerShell”

Invoke-WebRequest の場合

Write-Host “— Invoke-WebRequest の出力 —”
$webResponse = iwr -Uri $apiUrl

応答全体を含むオブジェクトが返される。Content は JSON 文字列

$webResponse.StatusCode
$webResponse.Headers.”Content-Type”
$webResponse.Content # JSON 文字列

$webResponse.Content | ConvertFrom-Json # 自分で変換が必要

Write-Host “`n— Invoke-RestMethod の出力 —”
$restResponse = irm -Uri $apiUrl

応答本文（JSON）が自動的に PowerShell オブジェクトに変換されて返される

$restResponse.login
$restResponse.public_repos
“`

ご覧のように、Invoke-RestMethodはAPIからのJSON応答を直接PowerShellオブジェクトとして扱えるため、API連携においてはInvoke-RestMethodの方が便利な場合が多いです。

しかし、以下のようなケースではInvoke-WebRequestを使う必要があります。

HTTPステータスコードやヘッダー情報を細かく確認・利用したい場合。
WebページのHTMLコンテンツを取得し、その生の文字列自体を処理したい場合（正規表現での抽出など）。
応答がバイナリファイルである場合（-OutFileを使う場合）。
応答が構造化データではない場合（単なるプレーンテキストなど）。

どちらを使うべきかは、実現したいことや、対象となるWebリソースの性質によって判断します。API連携で構造化データを扱うならInvoke-RestMethod、それ以外の広範なWeb操作や詳細なレスポンス情報の利用、ファイルダウンロードならInvoke-WebRequest、という使い分けが一般的です。

注意点：スムーズなWeb操作のために

Invoke-WebRequestは非常に便利ですが、使用する上でいくつか注意しておきたい点があります。

1. PowerShellのバージョンによる違い

既に述べたように、PowerShell Core (v6以降) および PowerShell 7 と、Windows PowerShell 5.1 では、特にHTML解析機能においてデフォルトの挙動が大きく異なります。

Windows PowerShell 5.1: デフォルトでHTMLを解析し、Forms, Links, Imagesなどのプロパティが利用可能。内部的にIEエンジンを利用。
PowerShell Core/7: デフォルトでBasicParsingを使用し、HTML解析機能は無効化（または非推奨）。高速だが、HTML構造解析は別途手段が必要。

互換性のために-UseBasicParsing:$falseを指定することも可能ですが、これは非推奨であり、将来的には削除される可能性があります。新しい環境でスクリプトを作成する場合は、BasicParsingを前提とし、HTML解析が必要なら外部モジュールなどを利用する方針をお勧めします。

2. 大規模なファイルのダウンロード

非常に大きなファイルをダウンロードする場合、Invoke-WebRequestはファイル全体をメモリに読み込んでからファイルに書き出すわけではありませんが、それでもダウンロード処理自体に時間がかかり、リソースを消費します。長時間かかるダウンロードの進捗表示機能がないことも、大規模ファイルでは不便に感じることがあります。

もし、非常に大規模なファイルを頻繁に扱う必要がある場合は、System.Net.WebClientクラスのDownloadFileAsyncメソッドや、PowerShell以外の専用ダウンロードツールを検討することも有効です。しかし、一般的なファイルダウンロードであればInvoke-WebRequest -OutFileで十分です。

3. Webサイトの利用規約とRobots.txt

自動化されたスクリプトでWebサイトにアクセスする場合、そのサイトの利用規約やrobots.txtファイルを必ず確認してください。一部のサイトは、自動化されたアクセスや過剰なリクエストを禁止している場合があります。マナーを守り、サイトに負荷をかけないように注意しましょう。特に、短時間に連続してリクエストを送る場合は、間隔を空けるなどの配慮が必要です。

4. User-Agentの設定

多くのWebサイトは、リクエストヘッダーに含まれるUser-Agent文字列を見て、どのようなクライアント（ブラウザ、検索エンジンボットなど）からのアクセスかを判断しています。デフォルトのUser-Agent（例: Mozilla/5.0 (Windows NT 10.0; Microsoft Windows 10.0.xxxxx) PowerShell/7.4.0）は、サーバーによっては自動化されたアクセスと判断され、アクセスが拒否される原因となることがあります。

もしアクセスがブロックされる場合は、ブラウザに偽装したUser-Agentを-Headersパラメータで設定してみる価値があります。ただし、これもサイトのポリシーによっては許容されない場合があるので注意が必要です。

5. エラーの詳細確認

try-catchブロック内でエラーを捕捉した場合、$_変数から様々な情報にアクセスできます。特に$_.Exceptionプロパティは、発生した例外オブジェクトを含んでおり、エラーの種類（System.Net.WebException, System.TimeoutExceptionなど）や詳細メッセージを確認できます。HTTPエラーの場合は、$_.Exception.Responseからステータスコードやヘッダーなどの応答情報を取得できることがあります（ただし、ネットワークエラーなどではResponseプロパティはnullになります）。エラーの原因究明のために、これらの情報を活用することが重要です。

まとめ：PowerShellにおけるWeb操作の要

この記事では、PowerShellにおけるwget相当の機能を提供するInvoke-WebRequestコマンドレットについて、基本的な使い方から応用、そして注意点までを詳細に解説しました。

Invoke-WebRequestは、指定したURIからWebリソースを取得するための非常に強力で柔軟なツールです。単にファイルをダウンロードするだけでなく、HTTPメソッドの指定、ヘッダーやボディのカスタマイズ、セッション管理など、Web通信における様々な要求に応えることができます。

特に以下の点を理解しておけば、PowerShellでWebリソースを効率的に扱うことができるようになります。

エイリアスiwrを覚えておくと便利です。
-Uriで取得対象を指定し、-OutFileでファイルに保存します。
-Method, -Headers, -Bodyパラメータでリクエストを詳細にカスタマイズできます。
-SessionVariableを使ってセッションを維持できます。
取得した応答はWebResponseObjectオブジェクトとして返され、StatusCode, Content, Headersなどのプロパティから情報を取り出せます。
try-catchブロックやStatusCodeのチェックを使って、エラーハンドリングをしっかり行いましょう。
構造化データ（JSON, XML）の取得にはInvoke-RestMethodも便利ですが、生の応答やHTMLを取得する場合はInvoke-WebRequestが適しています。

Invoke-WebRequestをマスターすることは、PowerShellを使ったスクリプトでWeb上の情報やサービスを活用するための重要なスキルとなります。Webサイトの自動監視、API連携、定期的なファイルダウンロードなど、様々な自動化タスクに役立てることができるでしょう。

この記事が、wgetユーザーの方々がPowerShell環境でスムーズにWeb操作に移行し、Invoke-WebRequestを効果的に活用するための一助となれば幸いです。ぜひ、実際にコマンドを実行してみて、その機能と可能性を体験してみてください。

参考文献・リソース

Microsoft Docs: Invoke-WebRequest:
https://learn.microsoft.com/ja-jp/powershell/module/microsoft.powershell.utility/invoke-webrequest (公式ドキュメント)
Microsoft Docs: Invoke-RestMethod:
https://learn.microsoft.com/ja-jp/powershell/module/microsoft.powershell.utility/invoke-restmethod (Invoke-RestMethod の公式ドキュメント)
PowerShell Gallery: Posh-HTML:
https://www.powershellgallery.com/packages/Posh-HTML/ (PowerShell 7以降でHTML解析を行いたい場合に便利なモジュール)

PowerShellでwgetしたい人必見！Invoke-WebRequest入門ガイド

はじめに：wgetユーザーのためのPowerShellの代替手段

wgetとは何か？（簡単に）

PowerShellにおけるwgetの代替：Invoke-WebRequest (iwr)

Invoke-WebRequestの基本：最初のステップ

最もシンプルな使い方：URLを指定してコンテンツを取得

実行例と出力の解説

HTMLコンテンツの取得と表示

HTMLの自動解析機能について（注意点）

Windows PowerShell 5.1の場合、または PowerShell 7+ で -UseBasicParsing:$false を指定した場合 (非推奨)

PowerShell 7 以降で HTML を解析する場合（例: Posh-HTML モジュールを使用）

Install-Module Posh-HTML # モジュールがインストールされていない場合

$html = iwr “https://example.com/” | ConvertFrom-Html

$html.Links # リンク情報を取得

様々なコンテンツタイプの取得と保存

バイナリデータの取得と保存 (-OutFile パラメータ)

例: PowerShell ロゴ画像をダウンロード

-OutFileとパイプライン

テキストファイルとして取得し、変数に格納してから保存する場合

リクエストのカスタマイズ：思い通りのリクエストを送る

メソッドの指定 (-Method)

ヘッダーの追加・変更 (-Headers)

例: User-Agent ヘッダーを変更する

パラメータの送信 (-Body)

GETリクエストでクエリパラメータを送信

例: 擬似的なログインフォーム送信（POSTリクエスト）

例: JSONデータをPOSTリクエストで送信

例: ファイルをアップロード (multipart/form-data) – これは少し複雑

Invoke-WebRequestで multipart/form-data を扱うのはやや面倒です。

通常は System.Net.Http.HttpClient を使う方が簡単ですが、基本的な考え方として Body にバイト配列を指定できることを示します。

単純なバイナリデータのPOST

クッキーとセッション管理 (-SessionVariable)

例: ログインして、ログイン後ページにアクセスする

セッションを格納する変数名を指定

ログインリクエスト（通常はPOST）

セッション変数に情報を格納

ログイン後ページへのアクセス

同じセッション変数を指定して、ログイン時に取得したクッキーを引き継ぐ

タイムアウトの設定 (-TimeoutSec)

例: タイムアウトを10秒に設定

認証 (-Credential)

例: Basic認証が必要なサイトにアクセス

出力の扱い：取得した情報を活用する

Responseオブジェクトの詳細

特定の情報の抽出

ヘッダーのContent-Typeを取得

応答本文を取得

HTML解析プロパティの利用（PowerShell 5.1 または -UseBasicParsing:$false 時）

Windows PowerShell 5.1 もしくは PowerShell 7+ で -UseBasicParsing:$false を指定した場合

$response = iwr “https://example.com/” -UseBasicParsing:$false

ページ内の全リンクのhref属性を取得

$response.Links.Href

ページ内の全フォームのaction属性を取得

$response.Forms.Action

ページ内の全画像のsrc属性とalt属性を取得

$response.Images | Select-Object Src, Alt

出力を変数に格納する

変数に格納されたオブジェクトのプロパティにアクセス

変換後のPowerShellオブジェクトのプロパティにアクセス

エラーハンドリング：問題発生時に適切に対応する

HTTPエラーへの対応 (-ErrorAction, -ErrorVariable)

例: 存在しないURLにアクセスし、エラー情報を取得

エラーが発生したかチェック

try-catchブロックによるエラーハンドリング

例: try-catch ブロックを使ったエラーハンドリング

応用例：Invoke-WebRequestを使いこなす

1. ファイルの自動ダウンロード

例: 最新のPowerShellリリースノートをダウンロードする

2. Web APIの呼び出しとJSON/XMLデータの処理

例: GitHub APIでユーザー情報を取得する

例: XML形式のAPI応答を処理 (例: Googleの古いSearch APIの形式を模倣)

実際のAPIに合わせて適切に設定

$apiResponse = iwr -Uri $xmlApiUrl -Headers @{“Accept” = “application/xml”} -ErrorAction Stop

応答本文がXML形式の場合

$xmlData = $apiResponse.Content | ConvertFrom-Xml

変換後のPowerShellオブジェクトからデータにアクセス

$xmlData.RootElement.ChildElement.Property

3. Webサイトのステータスチェック

例: 複数のWebサイトのステータスをチェックする

4. Webサイトからの情報抽出（簡易スクレイピング）

はじめに：`wget`ユーザーのためのPowerShellの代替手段

`wget`とは何か？（簡単に）

PowerShellにおける`wget`の代替：`Invoke-WebRequest` (iwr)

`Invoke-WebRequest`の基本：最初のステップ

バイナリデータの取得と保存 (`-OutFile` パラメータ)

`-OutFile`とパイプライン

メソッドの指定 (`-Method`)

ヘッダーの追加・変更 (`-Headers`)

パラメータの送信 (`-Body`)

クッキーとセッション管理 (`-SessionVariable`)

タイムアウトの設定 (`-TimeoutSec`)

認証 (`-Credential`)

HTML解析プロパティの利用（PowerShell 5.1 または `-UseBasicParsing:$false` 時）

HTTPエラーへの対応 (`-ErrorAction`, `-ErrorVariable`)

`try-catch`ブロックによるエラーハンドリング

応用例：`Invoke-WebRequest`を使いこなす

`Invoke-RestMethod`との違い

コメントする返信をキャンセル