Document Unix platform support for Get/Start/Stop/Restart-Service
Los mantenedores suelen responder en 1 día
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 85/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- powershell
- Área
- documentation
Línea de trabajo
Actualiza los cuatro artículos de cmdlets indicados en reference/7.7/Microsoft.PowerShell.Management: Get-Service.md, Start-Service.md, Stop-Service.md y Restart-Service.md. Empieza leyendo sus secciones DESCRIPTION, PARAMETERS, OUTPUTS y NOTES junto con el contenido sugerido en este issue. El trabajo estará terminado cuando los artículos describan la detección de los administradores de servicios de Unix, la salida de UnixServiceController, los requisitos de sudo y el comportamiento de los parámetros específico de cada plataforma, y eliminen las indicaciones de disponibilidad exclusiva en Windows.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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-Foocmdlet" instead of "New cmdlet."
Summary
PowerShell is adding Unix platform support for the Get-Service, Start-Service, Stop-Service, and Restart-Service cmdlets in PowerShell 7.7. The cmdlet references currently document these cmdlets as Windows-only; they need to describe the new Unix behavior, the returned UnixServiceController object, and the sudo requirements for service management.
Details
The change was proposed in PowerShell/PowerShell#18863 and is implemented in PowerShell/PowerShell#28385: on Linux and macOS, the four service cmdlets work through the system service manager, which is discovered in this order: systemctl (systemd), launchctl (macOS), service (sysvinit), and rc-service (OpenRC).
On Unix platforms:
- The cmdlets return UnixServiceController objects instead of System.ServiceProcess.ServiceController objects. The Status and StartType properties map the service manager state onto the same enumerations that are used on Windows.
- Getting service information doesn't require elevated permissions. The service management cmdlets require root privileges; when they aren't running as root, they wrap the service manager command with
sudo -nand write a non-terminating error when elevation isn't available. - The DependentServices and RequiredServices parameters are only populated by systemd.
- The Force parameter is accepted for script compatibility but has no effect on Unix.
- The remaining service cmdlets (
Set-Service,New-Service,Remove-Service,Suspend-Service, andResume-Service) stay Windows-only.
Articles
- Get-Service (
reference/7.7/Microsoft.PowerShell.Management/Get-Service.md) - Start-Service (
reference/7.7/Microsoft.PowerShell.Management/Start-Service.md) - Stop-Service (
reference/7.7/Microsoft.PowerShell.Management/Stop-Service.md) - Restart-Service (
reference/7.7/Microsoft.PowerShell.Management/Restart-Service.md)
Suggested updates:
- Remove the "This cmdlet is only available on the Windows platform." callouts and the Windows-only availability notes.
- Document the Unix service manager discovery order, the UnixServiceController output object, the sudo requirements, and the per-parameter platform behavior in the DESCRIPTION, PARAMETERS, OUTPUTS, and NOTES sections.
Suggested content
Unix support note for each cmdlet's DESCRIPTION section:
Beginning in PowerShell 7.7, this cmdlet is also available on Linux and macOS. On Unix platforms the cmdlet works through the system service manager, which it discovers in this order:
systemctl(systemd),launchctl(macOS),service(sysvinit), andrc-service(OpenRC). For more information, see the Notes section.
Unix output object section:
Microsoft.PowerShell.Commands.UnixServiceController
On Unix platforms, this cmdlet returns UnixServiceController objects that represent the services reported by the system service manager.
Related Source Pull Requests
Related Source Issues
- Lenguaje dominante
- PowerShell
- Estrellas
- 2.6k
- Forks
- 1.7k
- Merge medio
- 1 d 4 h
- PR fusionados (30 d)
- 4
Preparar el entorno
Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de MicrosoftDocs/PowerShell-Docs
-
issue-doc-bug needs-triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
MicrosoftDocs/PowerShell-Docs#13391 ·
Los mantenedores suelen responder en 1 día
-
Generalize the warning about combining number literals with decimal places with integer-type suffixesPosiblemente ocupada @Tegrask la tomó hace 2 días. Abiertoneeds-triage
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100
MicrosoftDocs/PowerShell-Docs#13384 ·
Los mantenedores suelen responder en 1 día
-
Document the renamed `-BasePath` parameter (formerly `-RelativeBasePath`) of Resolve-PathPosiblemente ocupada @soroshsabz la tomó hace 9 días. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 79/100
MicrosoftDocs/PowerShell-Docs#13379 ·
Los mantenedores suelen responder en 1 día
-
https://github.com/MicrosoftDocs/PowerShell-Docs/issues?q=state%3Aopen%20label%3A%22needs-triage%22Abiertoneeds-triage
Dificultad 1/5 Menos de una hora Aptitud para principiantes 65/100
MicrosoftDocs/PowerShell-Docs#13377 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
MicrosoftDocs/PowerShell-Docs#13375 ·
Los mantenedores suelen responder en 1 día
Todos los issues de MicrosoftDocs/PowerShell-Docs
Issues similares
-
area:agent-sdk area:docs documentation enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
anthropics/claude-code#110914 ·
-
specification
Dificultad 1/5 Menos de una hora Aptitud para principiantes 78/100
WICG/webmonetization#813 ·
Los mantenedores suelen responder en 3 días
-
documentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
-
Polish READMEAbiertodocumentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
-
Doc: Remove quotes and backticks around RFC objectsPosiblemente ocupada @Tirth00000 la tomó hoy. Abiertodoc good first issue help wanted
Dificultad 2/5 1-3 horas Aptitud para principiantes 67/100
collective/icalendar#2146 · 1 comentario ·