René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Stop-Computer: broken on macOS; suboptimal UX on all Unix-like platforms","articleBody":"### Prerequisites\r\n\r\n- [X] Write a descriptive title.\r\n- [X] Make sure you are able to repro it on the [latest released version](https://github.com/PowerShell/PowerShell/releases)\r\n- [X] Search the existing issues.\r\n- [X] Refer to the [FAQ](https://github.com/PowerShell/PowerShell/blob/master/docs/FAQ.md).\r\n- [X] Refer to [Differences between Windows PowerShell 5.1 and PowerShell](https://docs.microsoft.com/powershell/scripting/whats-new/differences-from-windows-powershell).\r\n\r\n### Steps to reproduce\r\n\r\nOn Unix-like platforms, `Stop-Computer` doesn't support arguments and simply invokes `/sbin/shutdown` - ultimately _argument-less_ - see:https://github.com/PowerShell/PowerShell/blob/0355d2f4df6ba3dec123f51475277bbf1fc0b37d/src/Microsoft.PowerShell.Commands.Management/commands/management/ComputerUnix.cs#L162\r\n\r\nThis causes `Stop-Computer` to malfunction on macOS, which _requires `-h now`_  in oder to initiate an immediate shutdown, rendering `Stop-Computer` useless on macOS.\r\n\r\n```powershell\r\n# !! Currently doesn't work on macOS.\r\nsudo pwsh -NoProfile -Command Stop-Computer\r\n```\r\n\r\nAs for the suboptimal UX, which applies to all Unix-like platforms:\r\n\r\n* The syntax diagram shows the Windows-only parameters.\r\n\r\n* Tab-completion completes the common parameters (only), even though they are useless.\r\n\r\n* Common parameters are _accepted_, but effectively _ignored_, which is especially treacherous with `-WhatIf`\r\n\r\n* An attempt to pass arguments through to `shutdown` fails, but with a nondescript error message (`A parameter cannot be found`) - a specific message indicating that pass-through arguments aren't supported would be more helpful.\r\n\r\n\r\n\r\n\r\n### Expected behavior\r\n\r\nAn immediate shutdown should be initiated.\r\n\r\n\r\n### Actual behavior\r\n\r\nThe `shutdown` call fails due to missing options and prints its usage message:\r\n\r\n```none\r\nusage: shutdown [-] [-h [-u] [-n] | -r [-n] | -s | -k] time [warning-message ...]\r\n```\r\n\r\n\r\n### Error details\r\n\r\n_No response_\r\n\r\n### Environment data\r\n\r\n```powershell\r\nPowerShell 7.4.0-preview.3 on macOS 13.3.1\r\n```\r\n\r\n\r\n### Visuals\r\n\r\n_No response_","author":{"url":"https://github.com/mklement0","@type":"Person","name":"mklement0"},"datePublished":"2023-06-03T17:51:06.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/19738/PowerShell/issues/19738"}