PowerShellでPOSTリクエストを送信する方法【初心者向け解決ガイド】

2025.08.192026.01.27

PowerShellを使って、WebサイトやAPIにデータを送信する「POSTリクエスト」を行いたいけれど、どうすればよいか分からないという方へ。今回は、初心者でも分かりやすく、実際の例を交えて解説します。

PowerShellでPOSTリクエストを送る基本の方法
POSTリクエストを送信する際の注意点
よくある質問や疑問
まとめ

PowerShellでPOSTリクエストを送る基本の方法

Windowsのイメージ

PowerShellには、HTTPリクエストを送信するためのコマンドレットがいくつかありますが、最もよく使われるのは以下の2つです。

ここがポイント！

Invoke-WebRequestWebページの取得やフォームの送信に使用します。
Invoke-RestMethodREST APIとの通信に特化しており、JSON形式のデータの送受信が得意です。

今回は、Invoke-RestMethodを使って、POSTリクエストを送る方法を紹介します。

基本的なPOSTリクエストの送信

以下のコマンドで、指定したURLにデータをPOSTできます。

$url = 'https://example.com/api'

$body = @{ key1 = 'value1'; key2 = 'value2' }

$response = Invoke-RestMethod -Uri $url -Method Post -Body $body

$response

このコマンドでは、key1とkey2というデータをvalue1とvalue2として送信しています。Invoke-RestMethodは、送信したデータに対するレスポンスを自動的に解析し、結果を返してくれます。

JSON形式でデータを送信する場合

APIによっては、データをJSON形式で送る必要があります。その場合、以下のようにします。

$url = 'https://example.com/api'

$body = @{ key1 = 'value1'; key2 = 'value2' } | ConvertTo-Json

$response = Invoke-RestMethod -Uri $url -Method Post -Body $body -ContentType 'application/json'

$response

ここでは、ConvertTo-Jsonを使って、ハッシュテーブルをJSON形式に変換しています。-ContentType ‘application/json’で、送信するデータがJSONであることをサーバーに伝えています。

ヘッダー情報を追加する場合

APIによっては、認証情報や特定のヘッダーを要求することがあります。以下のように、ヘッダーを追加できます。

$url = 'https://example.com/api'

$headers = @{ Authorization = 'Bearer your_token' }

$body = @{ key1 = 'value1'; key2 = 'value2' } | ConvertTo-Json

$response = Invoke-RestMethod -Uri $url -Method Post -Headers $headers -Body $body -ContentType 'application/json'

$response

この例では、AuthorizationヘッダーにBearerトークンを追加しています。

POSTリクエストを送信する際の注意点

POSTリクエストを送る際には、以下の点に注意してください。

ここがポイント！

Content-Type送信するデータの形式を指定します。JSONの場合はapplication/json、フォームデータの場合はapplication/x-www-form-urlencodedなどがあります。
ヘッダー情報APIによっては、認証情報や特定のヘッダーを要求することがあります。必要なヘッダーはAPIのドキュメントで確認してください。
エラーハンドリングリクエストが失敗することもあります。try-catch構文を使って、エラーを適切に処理しましょう。

よくある質問や疑問

Q1: POSTリクエストを送っても、サーバー側でデータが受け取れません。

サーバー側で受け取るデータの形式が間違っている可能性があります。Content-Typeや送信するデータの形式を再確認してください。

Q2: 認証が必要なAPIにアクセスするにはどうすればよいですか？

認証が必要なAPIには、ヘッダーに認証情報を追加する必要があります。例えば、Bearerトークンを使用する場合、ヘッダーにAuthorization = ‘Bearer your_token’を追加します。

Q3: レスポンスのデータをファイルに保存するにはどうすればよいですか？

レスポンスのデータをファイルに保存するには、以下のようにします。

$url = 'https://example.com/api'

$body = @{ key1 = 'value1'; key2 = 'value2' } | ConvertTo-Json

$response = Invoke-RestMethod -Uri $url -Method Post -Body $body -ContentType 'application/json'

$response | Out-File 'response.json'

このコマンドでは、レスポンスの内容をresponse.jsonというファイルに保存しています。