Remove Group Policy Assignment (GPA) content from Grant-CsDialoutPolicy - #13691
Conversation
Group Policy Assignment does not support the outbound calling restriction policy (OnlineDialOutPolicy), so the GrantToGroup path is inaccurate. Remove the GrantToGroup parameter set, the -Group and -Rank parameters, Example 5, and the related SYNOPSIS and NOTES text. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
Learn Build status updates of commit 5241104: ✅ Validation status: passed
For more details, please refer to the build report. |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
d-chetan Before this PR can be merged, you need to add the Sign off label to it. Before you sign off a PR, confirm the following:
After you've confirmed the above, do the following to sign off:
After you've signed off, our operations (PubOps) team will review the PR for issues that may impact formatting and the customer experience. If any changes are needed, they will return When the PR passes PubOps review, they'll merge the PR. If the PR is merged into the main branch, changes will go live within the next couple hours. If you have questions about this process, or need help signing off on this PR, post a message to https://aka.ms/tcphelp. |
|
Learn Build status updates of commit 9a470b7: ✅ Validation status: passed
For more details, please refer to the build report. |
|
d-chetan Before this PR can be merged, you need to add the Sign off label to it. Before you sign off a PR, confirm the following:
After you've confirmed the above, do the following to sign off:
After you've signed off, our operations (PubOps) team will review the PR for issues that may impact formatting and the customer experience. If any changes are needed, they will return When the PR passes PubOps review, they'll merge the PR. If the PR is merged into the main branch, changes will go live within the next couple hours. If you have questions about this process, or need help signing off on this PR, post a message to https://aka.ms/tcphelp. |
|
Learn Build status updates of commit 69fa602: ✅ Validation status: passed
For more details, please refer to the build report. |
ddd998e
into
MicrosoftDocs:main

Summary
Grant-CsDialoutPolicycurrently documents a Group Policy Assignment (GPA) path — theGrantToGroupparameter set with-Groupand-Rank. Group Policy Assignment does not support the outbound calling restriction policy (OnlineDialOutPolicy), so this content is inaccurate and can mislead admins into attempting group-based assignment that isn't supported.Evidence (public documentation)
The authoritative list of GPA-supported policy types is the
-PolicyTypeparameter of Get-CsGroupPolicyAssignment. That enumeration includes the sibling voice policies —OnlineVoiceRoutingPolicy,OnlineVoicemailPolicy,OnlineAudioConferencingRoutingPolicy,TeamsSharedCallingRoutingPolicy,CallingLineIdentity, andTenantDialPlan— but does not includeOnlineDialOutPolicy. Because Dialout is absent while its sibling voice policies are present, GPA is not supported for this policy type.Changes
Removed all GPA references from
Grant-CsDialoutPolicy.mdand added an explicit callout that GPA is unsupported:GrantToGroupparameter set-Group/-Rank)-Groupand-RankGrantToGroupversion note and added a callout stating that group policy assignment is not supported for the Dialout policyAdmins should continue to use per-user (
-Identity) or tenant global (-Global) assignment for outbound calling restriction policies.