Document Unix platform support for Get/Start/Stop/Restart-Service
I maintainer di solito rispondono entro 1 giorno
Valutazione
- Difficoltà
- 2/5
- Tempo stimato
- 1-3 ore
- Idoneità per principianti
- 85/100
- Tipo di issue
- Documentazione
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Attiva
- Stack tecnologico
- powershell
- Ambito
- documentation
Direzione di ricerca
Aggiorna i quattro articoli dei cmdlet indicati in reference/7.7/Microsoft.PowerShell.Management: Get-Service.md, Start-Service.md, Stop-Service.md e Restart-Service.md. Inizia leggendo le sezioni DESCRIPTION, PARAMETERS, OUTPUTS e NOTES insieme ai contenuti suggeriti in questo issue. Il lavoro è completato quando gli articoli descrivono il rilevamento dei gestori dei servizi Unix, l'output di UnixServiceController, i requisiti di sudo e il comportamento dei parametri specifico della piattaforma, e rimuovono le indicazioni di disponibilità esclusiva su Windows.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
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
- Lingua principale
- PowerShell
- Stelle
- 2.6k
- Fork
- 1.7k
- Merge medio
- 1g 4h
- PR unite (30g)
- 4
Preparare l'ambiente
Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di MicrosoftDocs/PowerShell-Docs
-
issue-doc-bug needs-triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
MicrosoftDocs/PowerShell-Docs#13391 ·
I maintainer di solito rispondono entro 1 giorno
-
Generalize the warning about combining number literals with decimal places with integer-type suffixesForse già presa @Tegrask l’ha presa 2 giorni fa. Apertaneeds-triage
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 82/100
MicrosoftDocs/PowerShell-Docs#13384 ·
I maintainer di solito rispondono entro 1 giorno
-
Document the renamed `-BasePath` parameter (formerly `-RelativeBasePath`) of Resolve-PathForse già presa @soroshsabz l’ha presa 9 giorni fa. Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 79/100
MicrosoftDocs/PowerShell-Docs#13379 ·
I maintainer di solito rispondono entro 1 giorno
-
https://github.com/MicrosoftDocs/PowerShell-Docs/issues?q=state%3Aopen%20label%3A%22needs-triage%22Apertaneeds-triage
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 65/100
MicrosoftDocs/PowerShell-Docs#13377 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
MicrosoftDocs/PowerShell-Docs#13375 ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di MicrosoftDocs/PowerShell-Docs
Issue simili
-
area:agent-sdk area:docs documentation enhancement
Difficoltà 2/5 1-3 ore Idoneità per principianti 66/100
anthropics/claude-code#110914 ·
-
specification
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 78/100
WICG/webmonetization#813 ·
I maintainer di solito rispondono entro 3 giorni
-
documentation
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
-
Polish READMEApertadocumentation
Difficoltà 2/5 1-3 ore Idoneità per principianti 66/100
-
Doc: Remove quotes and backticks around RFC objectsForse già presa @Tirth00000 l’ha presa oggi. Apertadoc good first issue help wanted
Difficoltà 2/5 1-3 ore Idoneità per principianti 67/100
collective/icalendar#2146 · 1 commento ·