Document Unix platform support for Get/Start/Stop/Restart-Service

Offen Anfängerfreundlich
#13,385 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

@soroshsabz arbeitet bereits daran.

Seit 10.11.2026.

  • #13383 von @soroshsabz — offen

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
85/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
powershell
Bereich
documentation

Rechercherichtung

Aktualisiere die vier benannten Cmdlet-Artikel unter reference/7.7/Microsoft.PowerShell.Management: Get-Service.md, Start-Service.md, Stop-Service.md und Restart-Service.md. Lies zunächst die Abschnitte DESCRIPTION, PARAMETERS, OUTPUTS und NOTES zusammen mit den in diesem Issue vorgeschlagenen Inhalten. Die Arbeit ist abgeschlossen, wenn die Artikel die Erkennung von Unix-Dienstmanagern, die Ausgabe von UnixServiceController, sudo-Anforderungen und plattformspezifisches Parameterverhalten beschreiben und Hinweise auf die Verfügbarkeit nur unter Windows entfernen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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 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 -n and 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, and Resume-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:

  1. Remove the "This cmdlet is only available on the Windows platform." callouts and the Windows-only availability notes.
  2. 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), and rc-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
Vorherrschende Sprache
PowerShell
Sterne
2.6k
Forks
1.7k
Ø Merge
1 T. 4 Std.
Gemergte PRs (30 T.)
4

Entwicklungsumgebung

In Codespaces öffnen

Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus MicrosoftDocs/PowerShell-Docs

Alle Issues in MicrosoftDocs/PowerShell-Docs

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.