René's URL Explorer Experiment


Title: Parameters Should Support Mutual Exclusion Natively · Issue #5175 · PowerShell/PowerShell · GitHub

Open Graph Title: Parameters Should Support Mutual Exclusion Natively · Issue #5175 · PowerShell/PowerShell

X Title: Parameters Should Support Mutual Exclusion Natively · Issue #5175 · PowerShell/PowerShell

Description: Problem Parameter sets are great for grouping parameters into sets that work together. This can, to some degree, also be used to make parameters exclusive. The problem arises when you have mutually exclusive parameters that need to exist...

Open Graph Description: Problem Parameter sets are great for grouping parameters into sets that work together. This can, to some degree, also be used to make parameters exclusive. The problem arises when you have mutually...

X Description: Problem Parameter sets are great for grouping parameters into sets that work together. This can, to some degree, also be used to make parameters exclusive. The problem arises when you have mutually...

Opengraph URL: https://github.com/PowerShell/PowerShell/issues/5175

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Parameters Should Support Mutual Exclusion Natively","articleBody":"# Problem\r\n\r\nParameter sets are great for grouping parameters into sets that work together. This can, to some degree, also be used to make parameters exclusive. The problem arises when you have mutually exclusive parameters that need to exist in all parameter sets. The current implementation would require creating additional parameter sets to accommodate the actual parameter sets and the mutually exclusive parameters.\r\n\r\nFor very simplistic demonstration, lets say you have a `New-Widget`:\r\n\r\n```powershell\r\nfunction New-Widget {\r\n    [CmdletBinding()]\r\n    param (\r\n        [Parameter(ParameterSetName=\"Size\")]\r\n        [int]$Height,\r\n        [Parameter(ParameterSetName=\"Size\")]\r\n        [int]$Width,\r\n        [Parameter(ParameterSetName=\"Size\")]\r\n        [int]$Length,\r\n\r\n        [Parameter(ParameterSetName=\"Color\")]\r\n        [int]$Red,\r\n        [Parameter(ParameterSetName=\"Color\")]\r\n        [int]$Green,\r\n        [Parameter(ParameterSetName=\"Color\")]\r\n        [int]$Blue\r\n    )\r\n}\r\n``` \r\n\r\nWidgets can be defined either by color or size. Now, let say that all widgets, regardless of begin defined by size or color, can either have a flavor or a sound but not both. Currently, to accommodate this you would need to do the following:\r\n\r\n```powershell\r\nfunction New-Widget {\r\n    [CmdletBinding()]\r\n    param (\r\n        [Parameter(ParameterSetName=\"SizeFlavor\")]\r\n        [Parameter(ParameterSetName=\"SizeSound\")]\r\n        [int]$Height,\r\n        [Parameter(ParameterSetName=\"SizeFlavor\")]\r\n        [Parameter(ParameterSetName=\"SizeSound\")]\r\n        [int]$Width,\r\n        [Parameter(ParameterSetName=\"SizeSound\")]\r\n        [Parameter(ParameterSetName=\"SizeFlavor\")]\r\n        [int]$Length,\r\n\r\n        [Parameter(ParameterSetName=\"ColorFlavor\")]\r\n        [Parameter(ParameterSetName=\"ColorSound\")]\r\n        [int]$Red,\r\n        [Parameter(ParameterSetName=\"ColorSound\")]\r\n        [Parameter(ParameterSetName=\"ColorFlavor\")]\r\n        [int]$Green,\r\n        [Parameter(ParameterSetName=\"ColorSound\")]\r\n        [Parameter(ParameterSetName=\"ColorFlavor\")]\r\n        [int]$Blue,\r\n\r\n        [Parameter(ParameterSetName=\"SizeFlavor\")]\r\n        [Parameter(ParameterSetName=\"ColorFlavor\")]\r\n        [string]$Flavor,\r\n\r\n        [Parameter(ParameterSetName=\"SizeSound\")]\r\n        [Parameter(ParameterSetName=\"ColorSound\")]\r\n        [string]$Sound\r\n    )\r\n}\r\n```\r\n\r\nThis can get wildly out of hand if you have a third or fourth set of mutually exclusive parameters. This becomes difficult to maintain and to add additional parameters. Another option is to have logic in the body of the function to check for mutually exclusive Parameters at the cost of the mutual exclusion not being as discoverable.\r\n\r\nIn some instances you may be able to refactor into additional cmdlets or make use of custom types. But that doesn't always work for command line utilities meant to ease user burden at the cost of code complexity. \r\n\r\n# Proposal\r\nI propose that parameters should support mutual exclusion natively. I don't have a solid implementation plan, but one idea would be to add a Parameter Attribute property like `ParameterMutexName`. Using the example above it would work like this:\r\n\r\n```powershell\r\nfunction New-Widget {\r\n    [CmdletBinding()]\r\n    param (\r\n        [Parameter(ParameterSetName=\"Size\")]\r\n        [int]$Height,\r\n        [Parameter(ParameterSetName=\"Size\")]\r\n        [int]$Width,\r\n        [Parameter(ParameterSetName=\"Size\")]\r\n        [int]$Length,\r\n\r\n        [Parameter(ParameterSetName=\"Color\")]\r\n        [int]$Red,\r\n        [Parameter(ParameterSetName=\"Color\")]\r\n        [int]$Green,\r\n        [Parameter(ParameterSetName=\"Color\")]\r\n        [int]$Blue,\r\n\r\n        [Parameter(ParameterSetName=\"Size\", ParameterMutexName=\"FlavorOrSound\")]\r\n        [Parameter(ParameterSetName=\"Color\", ParameterMutexName=\"FlavorOrSound\")]\r\n        [string]$Flavor,\r\n        [Parameter(ParameterSetName=\"Size\", ParameterMutexName=\"FlavorOrSound\")]\r\n        [Parameter(ParameterSetName=\"Color\", ParameterMutexName=\"FlavorOrSound\")]\r\n        [string]$Sound\r\n    )\r\n}\r\n```\r\n\r\nParameter binding logic would then check if more than one parameter is supplied in a `ParameterMutexName` and throw. This is flexible enough to accommodate parameters being exclusive in one set while not exclusive in other sets. This could also accommodate multiple Mutex sets within a parameter set.","author":{"url":"https://github.com/markekraus","@type":"Person","name":"markekraus"},"datePublished":"2017-10-19T22:49:17Z","url":"https://github.com/PowerShell/PowerShell/issues/5175"}

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:7de8fe29-8504-7a48-a811-85f5f1180e5e
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idCB6A:7AB3A:1CEEBB:2841A2:6AFD8096
html-safe-nonce5336c523b7e3b301c45fa7a1eb4cd9b19055ac04ff0593c9cb548c5d8290278a
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDQjZBOjdBQjNBOjFDRUVCQjoyODQxQTI6NkFGRDgwOTYiLCJ2aXNpdG9yX2lkIjoiMjg4NjMwNjUzNTM5MzAzNDM5MCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac4c2f5d265e4152234b355565d7c81f5a8b358cc88250e5557379976114561fe6
hovercard-subject-tagissue:267013199
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/PowerShell/PowerShell/5175/issue_layout
twitter:imagehttps://opengraph.githubassets.com/bcf64be6fef1cb8f15f5184ef31c3efae488a28adcddb48d798e475b267d9577/PowerShell/PowerShell/issues/5175
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/bcf64be6fef1cb8f15f5184ef31c3efae488a28adcddb48d798e475b267d9577/PowerShell/PowerShell/issues/5175
og:image:altProblem Parameter sets are great for grouping parameters into sets that work together. This can, to some degree, also be used to make parameters exclusive. The problem arises when you have mutually...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamemarkekraus
hostnamegithub.com
expected-hostnamegithub.com
None42d4967e3c8afca51ccac31f419a705af777226a95f025ea73387d87a306b326
turbo-cache-controlno-preview
go-importgithub.com/PowerShell/PowerShell git https://github.com/PowerShell/PowerShell.git
octolytics-dimension-user_id11524380
octolytics-dimension-user_loginPowerShell
octolytics-dimension-repository_id49609581
octolytics-dimension-repository_nwoPowerShell/PowerShell
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id49609581
octolytics-dimension-repository_network_root_nwoPowerShell/PowerShell
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release2329ceed0bc2c7b7c3b9f5f2db6abfc7b6fc3a50
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/PowerShell/PowerShell/issues/5175#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FPowerShell%2FPowerShell%2Fissues%2F5175
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FPowerShell%2FPowerShell%2Fissues%2F5175
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=PowerShell%2FPowerShell
Reloadhttps://github.com/PowerShell/PowerShell/issues/5175
Reloadhttps://github.com/PowerShell/PowerShell/issues/5175
Reloadhttps://github.com/PowerShell/PowerShell/issues/5175
PowerShellhttps://github.com/PowerShell
PowerShellhttps://github.com/PowerShell/PowerShell
Codehttps://github.com/PowerShell/PowerShell
Issues1.3k (1.3k)https://github.com/PowerShell/PowerShell/issues
Pull requests366 (366)https://github.com/PowerShell/PowerShell/pulls
Discussionshttps://github.com/PowerShell/PowerShell/discussions
Actionshttps://github.com/PowerShell/PowerShell/actions
Projectshttps://github.com/PowerShell/PowerShell/projects
Security and quality3 (3)https://github.com/PowerShell/PowerShell/security
Insightshttps://github.com/PowerShell/PowerShell/insights
https://github.com/PowerShell/PowerShell
New issuehttps://github.com/login?return_to=https://github.com/PowerShell/PowerShell/issues/5175
New issuehttps://github.com/login?return_to=https://github.com/PowerShell/PowerShell/issues/5175
Parameters Should Support Mutual Exclusion Nativelyhttps://github.com/PowerShell/PowerShell/issues/5175#top
Issue-Discussionthe issue may not have a clear classification yet. The issue may generate an RFC or may be reclassifhttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Discussion%22
Issue-Enhancementthe issue is more of a feature request than a bughttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Enhancement%22
Resolution-No ActivityIssue has had no activity for 6 months or morehttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Resolution-No%20Activity%22
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 19, 2017https://github.com/PowerShell/PowerShell/issues/5175#issue-267013199
Nexthttps://github.com/PowerShell/PowerShell/issues/5175?timeline_page=1
Mark Kraus (markekraus)https://github.com/markekraus
Issue-Discussionthe issue may not have a clear classification yet. The issue may generate an RFC or may be reclassifhttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Discussion%22
Issue-Enhancementthe issue is more of a feature request than a bughttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Enhancement%22
on Oct 19, 2017https://github.com/PowerShell/PowerShell/issues/5175#event-1302072401
https://github.com/SteveL-MSFT
Steve Lee (SteveL-MSFT)https://github.com/SteveL-MSFT
on Oct 19, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338068533
Mark Kraus (@markekraus)https://github.com/markekraus
https://github.com/PowerShell/PowerShell-RFC/blob/master/X-Withdrawn/RFC0001-Mutual-Exclusion-Parameters-and-Properties.mdhttps://github.com/PowerShell/PowerShell-RFC/blob/master/X-Withdrawn/RFC0001-Mutual-Exclusion-Parameters-and-Properties.md
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 20, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338072844
Steve Lee (@SteveL-MSFT)https://github.com/SteveL-MSFT
https://github.com/SteveL-MSFT
Steve Lee (SteveL-MSFT)https://github.com/SteveL-MSFT
on Oct 20, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338084690
https://github.com/iSazonov
Ilya (iSazonov)https://github.com/iSazonov
on Oct 20, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338098066
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 20, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338163328
Steve Lee (@SteveL-MSFT)https://github.com/SteveL-MSFT
Ilya (@iSazonov)https://github.com/iSazonov
https://github.com/iSazonov
Ilya (iSazonov)https://github.com/iSazonov
on Oct 20, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338193454
https://github.com/SteveL-MSFT
Steve Lee (SteveL-MSFT)https://github.com/SteveL-MSFT
on Oct 20, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338303775
Mark Kraus (@markekraus)https://github.com/markekraus
Mark Kraus (@markekraus)https://github.com/markekraus
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 20, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338323088
https://github.com/iSazonov
Ilya (iSazonov)https://github.com/iSazonov
on Oct 21, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338427976
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 21, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338428421
Ilya (@iSazonov)https://github.com/iSazonov
https://github.com/lzybkr
Jason Shirk (lzybkr)https://github.com/lzybkr
on Oct 21, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338432118
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 21, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338434387
Jason Shirk (@lzybkr)https://github.com/lzybkr
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 21, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338434621
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 22, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338500469
https://github.com/iSazonov
Ilya (iSazonov)https://github.com/iSazonov
on Oct 22, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338500779
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 22, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338501162
Ilya (@iSazonov)https://github.com/iSazonov
https://github.com/lzybkr
Jason Shirk (lzybkr)https://github.com/lzybkr
on Oct 23, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338754862
https://github.com/iSazonov
Ilya (iSazonov)https://github.com/iSazonov
on Oct 24, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-338975115
https://github.com/markekraus
Mark Kraus (markekraus)https://github.com/markekraus
on Oct 24, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-339060604
https://github.com/iSazonov
Ilya (iSazonov)https://github.com/iSazonov
on Oct 24, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-339075009
https://github.com/SteveL-MSFT
Steve Lee (SteveL-MSFT)https://github.com/SteveL-MSFT
on Nov 19, 2017https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-345541366
#5435https://github.com/PowerShell/PowerShell/pull/5435
https://github.com/apps/microsoft-github-policy-service
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
on Nov 16, 2023https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-1814050226
Microsoft GitHub Policy Servicehttps://aka.ms/1es-gitops
https://github.com/apps/microsoft-github-policy-service
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
on Nov 16, 2023https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-1814050228
Microsoft GitHub Policy Servicehttps://aka.ms/1es-gitops
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
Resolution-No ActivityIssue has had no activity for 6 months or morehttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Resolution-No%20Activity%22
on Nov 16, 2023https://github.com/PowerShell/PowerShell/issues/5175#event-10977848672
https://github.com/apps/microsoft-github-policy-service
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
on Nov 16, 2023https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-1814058853
Microsoft GitHub Policy Servicehttps://aka.ms/1es-gitops
https://github.com/apps/microsoft-github-policy-service
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
on Nov 23, 2023https://github.com/PowerShell/PowerShell/issues/5175#issuecomment-1824448824
Microsoft GitHub Policy Servicehttps://aka.ms/1es-gitops
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
completedhttps://github.com/PowerShell/PowerShell/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
on Nov 23, 2023https://github.com/PowerShell/PowerShell/issues/5175#event-11047807626
Sign up for freehttps://github.com/signup?return_to=https://github.com/PowerShell/PowerShell/issues/5175
Sign in to commenthttps://github.com/login?return_to=https://github.com/PowerShell/PowerShell/issues/5175
Issue-Discussionthe issue may not have a clear classification yet. The issue may generate an RFC or may be reclassifhttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Discussion%22
Issue-Enhancementthe issue is more of a feature request than a bughttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Enhancement%22
Resolution-No ActivityIssue has had no activity for 6 months or morehttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Resolution-No%20Activity%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.