Skip to content

Remove Group Policy Assignment (GPA) content from Grant-CsDialoutPolicy - #13691

Merged
Ruchika Mittal (Ruchika-mittal01) merged 3 commits into
MicrosoftDocs:mainfrom
d-chetan:fix/remove-gpa-dialoutpolicy
Jul 7, 2026
Merged

Remove Group Policy Assignment (GPA) content from Grant-CsDialoutPolicy#13691
Ruchika Mittal (Ruchika-mittal01) merged 3 commits into
MicrosoftDocs:mainfrom
d-chetan:fix/remove-gpa-dialoutpolicy

Conversation

@d-chetan

@d-chetan d-chetan commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Grant-CsDialoutPolicy currently documents a Group Policy Assignment (GPA) path — the GrantToGroup parameter set with -Group and -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 -PolicyType parameter of Get-CsGroupPolicyAssignment. That enumeration includes the sibling voice policies — OnlineVoiceRoutingPolicy, OnlineVoicemailPolicy, OnlineAudioConferencingRoutingPolicy, TeamsSharedCallingRoutingPolicy, CallingLineIdentity, and TenantDialPlan — but does not include OnlineDialOutPolicy. 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.md and added an explicit callout that GPA is unsupported:

  • SYNOPSIS — removed "a group of users,"
  • SYNTAX — removed the GrantToGroup parameter set
  • EXAMPLES — removed Example 5 (-Group / -Rank)
  • PARAMETERS — removed -Group and -Rank
  • NOTES — removed the GrantToGroup version note and added a callout stating that group policy assignment is not supported for the Dialout policy

Admins should continue to use per-user (-Identity) or tenant global (-Global) assignment for outbound calling restriction policies.

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-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 5241104:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Grant-CsDialoutPolicy.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

d-chetan
You have permissions to sign off pull requests in this repository. Reviewers will not be added to this PR.

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:

  • The PR is not in draft state. When the changes in this PR are ready to be published, select the Ready to merge button at the bottom of the page.
  • Article content has been checked for technical accuracy.
  • There are no errors or warnings in build validation.
  • There are no severity 1 or 2 PoliCheck issues.
  • All required PR checks at the bottom of the PR are passing.

After you've confirmed the above, do the following to sign off:

  1. Select the gear next to Labels.
  2. Select Sign off from the label list.
  3. Click away from the label list.

image

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
the PR to you with required changes. After they've completed those changes, you need to sign off again.

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-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 9a470b7:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Grant-CsDialoutPolicy.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@d-chetan d-chetan added the Sign off The pull request is ready to be reviewed and merged by PubOps label Jul 7, 2026
@Ruchika-mittal01 Ruchika Mittal (Ruchika-mittal01) added the In review PubOps is reviewing the pull request label Jul 7, 2026
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

d-chetan
You have permissions to sign off pull requests in this repository. Reviewers will not be added to this PR.

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:

  • The PR is not in draft state. When the changes in this PR are ready to be published, select the Ready to merge button at the bottom of the page.
  • Article content has been checked for technical accuracy.
  • There are no errors or warnings in build validation.
  • There are no severity 1 or 2 PoliCheck issues.
  • All required PR checks at the bottom of the PR are passing.

After you've confirmed the above, do the following to sign off:

  1. Select the gear next to Labels.
  2. Select Sign off from the label list.
  3. Click away from the label list.

image

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
the PR to you with required changes. After they've completed those changes, you need to sign off again.

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-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 69fa602:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Grant-CsDialoutPolicy.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@Ruchika-mittal01
Ruchika Mittal (Ruchika-mittal01) merged commit ddd998e into MicrosoftDocs:main Jul 7, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

In review PubOps is reviewing the pull request Microsoft submitter Sign off The pull request is ready to be reviewed and merged by PubOps teams-powershell/svc

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants