Document Unix platform support for Get/Start/Stop/Restart-Service
Les mainteneurs répondent en général sous 1 jour
Évaluation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Accessibilité débutants
- 85/100
- Type d'issue
- Documentation
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- powershell
- Domaine
- documentation
Piste de recherche
Mettez à jour les quatre articles de cmdlets nommés sous reference/7.7/Microsoft.PowerShell.Management : Get-Service.md, Start-Service.md, Stop-Service.md et Restart-Service.md. Commencez par lire leurs sections DESCRIPTION, PARAMETERS, OUTPUTS et NOTES en parallèle du contenu suggéré dans cet issue. Le travail est terminé lorsque les articles décrivent la détection des gestionnaires de services Unix, la sortie de UnixServiceController, les exigences liées à sudo et le comportement des paramètres propre à chaque plateforme, et suppriment les indications de disponibilité réservée à Windows.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
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
- Langage dominant
- PowerShell
- Étoiles
- 2.6k
- Forks
- 1.7k
- Merge moyen
- 1 j 4 h
- PR mergées (30 j)
- 4
Préparer son environnement
Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de MicrosoftDocs/PowerShell-Docs
-
issue-doc-bug needs-triage
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
MicrosoftDocs/PowerShell-Docs#13391 ·
Les mainteneurs répondent en général sous 1 jour
-
Generalize the warning about combining number literals with decimal places with integer-type suffixesPeut-être pris @Tegrask l’a pris il y a 2 jours. Ouverteneeds-triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
MicrosoftDocs/PowerShell-Docs#13384 ·
Les mainteneurs répondent en général sous 1 jour
-
Document the renamed `-BasePath` parameter (formerly `-RelativeBasePath`) of Resolve-PathPeut-être pris @soroshsabz l’a pris il y a 9 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 79/100
MicrosoftDocs/PowerShell-Docs#13379 ·
Les mainteneurs répondent en général sous 1 jour
-
https://github.com/MicrosoftDocs/PowerShell-Docs/issues?q=state%3Aopen%20label%3A%22needs-triage%22Ouverteneeds-triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 65/100
MicrosoftDocs/PowerShell-Docs#13377 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 65/100
MicrosoftDocs/PowerShell-Docs#13375 ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de MicrosoftDocs/PowerShell-Docs
Issues similaires
-
Issue-Docs Needs-Triage
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
microsoft/winget-cli#6692 ·
Les mainteneurs répondent en général sous 2 jours
-
Difficulté 1/5 1-3 heures Accessibilité débutants 66/100
microsoft/ignite26-LAB672#21 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 65/100
lean-ja/lean-by-example#2651 ·
-
area:agent-sdk area:docs documentation enhancement
Difficulté 2/5 1-3 heures Accessibilité débutants 66/100
anthropics/claude-code#110914 ·
-
specification
Difficulté 1/5 Moins d'une heure Accessibilité débutants 78/100
WICG/webmonetization#813 ·
Les mainteneurs répondent en général sous 3 jours