Edit

Share via

Get-CsGroupPolicyAssignment

  • Reference
Module:
MicrosoftTeamsPowerShell

This cmdlet is used to return group policy assignments.

Syntax

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

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. Possible values:

ApplicationAccessPolicy CallingLineIdentity ExternalAccessPolicy OnlineAudioConferencingRoutingPolicy OnlineVoicemailPolicy OnlineVoiceRoutingPolicy TeamsAppSetupPolicy TeamsAudioConferencingPolicy TeamsCallHoldPolicy TeamsCallingPolicy TeamsCallParkPolicy TeamsChannelsPolicy TeamsComplianceRecordingPolicy TeamsCortanaPolicy TeamsEmergencyCallingPolicy TeamsEmergencyCallRoutingPolicy TeamsEnhancedEncryptionPolicy TeamsEventsPolicy TeamsFeedbackPolicy TeamsFilesPolicy TeamsIPPhonePolicy TeamsMediaLoggingPolicy TeamsMeetingBrandingPolicy TeamsMeetingBroadcastPolicy TeamsMeetingPolicy TeamsMeetingTemplatePermissionPolicy TeamsMessagingPolicy TeamsMobilityPolicy TeamsRoomVideoTeleConferencingPolicy TeamsSharedCallingRoutingPolicy TeamsShiftsPolicy TeamsUpdateManagementPolicy TeamsVdiPolicy TeamsVideoInteropServicePolicy TeamsVirtualAppointmentsPolicy TenantDialPlan

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