Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Document the new `Query` value for the `-Method` parameter of Invoke-WebRequest and Invoke-RestMethod

オープン 初心者向け
  • 何か問題がありますか？
#13,306 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜2日
初心者へのやさしさ
86/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
powershell
領域
documentation

調査の方向性

reference/7.6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md と Invoke-RestMethod.md から始め、-Method パラメーターのセクションとその周辺の例を読んでください。Query を有効な値に追加し、適切な例を使ってリクエストボディの動作を文書化してから、両方の記事がリポジトリのドキュメント規約に従い、正しくレンダリングされることを確認してください。

索引モデルが issue の本文から書いたものです。

説明

issue-doc-idea needs-triage
Prerequisites
  • Existing Issue: Search the existing issues for this repository. If there is an issue that fits your needs do not file a new one. Subscribe, react, or comment on that issue instead.
  • Descriptive Title: Write the title for this issue as a short synopsis. If possible, provide context. For example, "Document new Get-Foo cmdlet" instead of "New cmdlet."
Summary

PowerShell is adding support for the standard HTTP QUERY method to Invoke-WebRequest and Invoke-RestMethod. A new Query value has been added to the WebRequestMethod enum (the valid set for the -Method parameter), implemented on top of .NET 10's new System.Net.Http.HttpMethod.Query API.

Details

The QUERY method is a safe, idempotent method defined by the IETF that is like GET, but sends its payload in the request body instead of the URI. This allows large or structured search/query parameters to be submitted without URI length limits. For more information, see the HTTP QUERY method (IETF) and MDN: HTTP QUERY method.

Articles

Suggested updates:

  1. Add Query to the -Method parameter description and the list of valid values.
  2. Add one or two examples (see below).
Suggested content

Parameter description for -Method:

Specifies the HTTP method used for the request. QUERY sends a safe, idempotent request whose parameters are carried in the request body rather than the URI. When -Body is a hashtable, it is sent as the request content (not converted into URI query parameters as with GET).

Example:

Invoke-RestMethod -Uri 'https://api.example.com/search' -Method Query `
    -Body @{ q = 'powershell'; limit = 10 } `
    -ContentType 'application/x-www-form-urlencoded'

Example:

$body = @{ query = 'SELECT * FROM events'; from = '2026-01-01' } | ConvertTo-Json
Invoke-WebRequest -Uri 'https://api.example.com/sql' -Method Query -Body $body -ContentType 'application/json'
Related Source Pull Requests
Related Source Issues
主要言語
PowerShell
スター
2.5k
フォーク
1.7k
平均マージ
6時間 58分
マージ済み PR（30日）
31

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

MicrosoftDocs/PowerShell-Docs のほかの issue

MicrosoftDocs/PowerShell-Docs の issue をすべて見る

似ている issue

Documentation の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。