Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
  • ¿Algo no está bien?
#13,306 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-2 días
Aptitud para principiantes
86/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
powershell
Área
documentation

Línea de trabajo

Comienza con reference/7.6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md e Invoke-RestMethod.md, leyendo sus secciones sobre el parámetro -Method y los ejemplos cercanos. Añade Query a los valores válidos y documenta el comportamiento de su cuerpo de solicitud con ejemplos adecuados; después, verifica que ambos artículos sigan las convenciones de documentación del repositorio y se rendericen correctamente.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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
Lenguaje dominante
PowerShell
Estrellas
2.5k
Forks
1.7k
Merge medio
6 h 43 min
PR fusionados (30 d)
34

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de MicrosoftDocs/PowerShell-Docs

Todos los issues de MicrosoftDocs/PowerShell-Docs

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.