Edit

Share via

Get-CsGroupPolicyAssignment

  • Reference
Module:
MicrosoftTeamsPowerShell

This cmdlet is used to return group policy assignments.

Syntax

Get-CsGroupPolicyAssignment
   [-GroupId <String>]
   [-PolicyType <String>]

Description

This cmdlets returns group policy assignments. Optional parameters allow the results to be restricted to policies assigned to a specific group or policies of a specific type.

Examples

Example 1

In this example, all group policy assignments are returned.

Get-CsGroupPolicyAssignment 

GroupId                              PolicyType                  PolicyName         Rank CreatedTime            CreatedBy
-------                              ----------                  ----------         ---- -----------            ---------
566b8d39-5c5c-4aaa-bc07-4f36278a1b38 TeamsMeetingBroadcastPolicy Vendor Live Events 1    10/25/2019 12:40:09 AM aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
d8ebfa45-0f28-4d2d-9bcc-b158a49e2d17 TeamsMeetingPolicy          AllOn              1    10/29/2019 3:57:27 AM  aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
e2a3ed24-97be-494d-8d3c-dbc04cbb878a TeamsCallingPolicy          AllowCalling       1    11/4/2019 12:54:27 AM  aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
19b881b4-c54c-4075-b1e8-a6ce55b12818 TeamsMeetingPolicy          Kiosk              2    11/1/2019 8:22:06 PM   aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
0c0c1b45-bfc9-4718-b8ae-291439ac6fa4 TeamsCallingPolicy          AllowCalling       2    11/1/2019 10:51:43 PM  aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
19c4909c-7d34-4e1f-b736-47caa2205768 TeamsMeetingBroadcastPolicy Employees Events   2    11/4/2019 12:56:57 AM  aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
566b8d39-5c5c-4aaa-bc07-4f36278a1b38 TeamsCallingPolicy          DisallowCalling    3    11/1/2019 10:53:16 PM  aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64

Example 2

In this example, only the policies assigned to a specific group are returned.

Get-CsGroupPolicyAssignment -GroupId e050ce51-54bc-45b7-b3e6-c00343d31274

GroupId                              PolicyType                  PolicyName         Rank CreatedTime            CreatedBy
-------                              ----------                  ----------         ---- -----------            ---------
566b8d39-5c5c-4aaa-bc07-4f36278a1b38 TeamsMeetingBroadcastPolicy Vendor Live Events 1    10/25/2019 12:40:09 AM aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
566b8d39-5c5c-4aaa-bc07-4f36278a1b38 TeamsCallingPolicy          AllowCalling       3    11/1/2019 10:53:16 PM  aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
566b8d39-5c5c-4aaa-bc07-4f36278a1b38 TeamsMeetingPolicy          kiosk              7    11/2/2019 12:14:41 AM  aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64

Example 3

In this example, only the policies of a specific type are returned.

Get-CsGroupPolicyAssignment -PolicyType TeamsCallingPolicy

GroupId                              PolicyType         PolicyName   Rank CreatedTime           CreatedBy
-------                              ----------         ----------   ---- -----------           ---------
e2a3ed24-97be-494d-8d3c-dbc04cbb878a TeamsCallingPolicy AllowCalling 1    11/4/2019 12:54:27 AM aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
0c0c1b45-bfc9-4718-b8ae-291439ac6fa4 TeamsCallingPolicy AllowCalling 2    11/1/2019 10:51:43 PM aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64
566b8d39-5c5c-4aaa-bc07-4f36278a1b38 TeamsCallingPolicy AllowCalling 3    11/1/2019 10:53:16 PM aeb7c0e7-2f6d-43ef-bf33-bfbcb93fdc64

Parameters

-GroupId

The ID of a group whose policy assignments will be returned.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PolicyType

The policy type for which group policy assignments will be returned.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False