TeamsGroupPolicyAssignment¶
Parameters¶
| Parameter | Attribute | DataType | Description | Allowed Values |
|---|---|---|---|---|
| GroupDisplayName | Key | String | Group Displayname of the group the policies are assigned to | |
| GroupId | Write | String | GroupId, alternatively to Group Displayname | |
| PolicyType | Key | String | Teams PolicyType. The type of the policy to be assigned. Possible values: | ApplicationAccessPolicy, CallingLineIdentity, OnlineAudioConferencingRoutingPolicy, OnlineVoicemailPolicy, OnlineVoiceRoutingPolicy, TeamsAudioConferencingPolicy, TeamsCallHoldPolicy, TeamsCallParkPolicy, TeamsChannelsPolicy, TeamsComplianceRecordingPolicy, TeamsCortanaPolicy, TeamsEmergencyCallingPolicy, TeamsEnhancedEncryptionPolicy, TeamsFeedbackPolicy, TeamsFilesPolicy, TeamsIPPhonePolicy, TeamsMediaLoggingPolicy, TeamsMeetingBroadcastPolicy, TeamsMeetingPolicy, TeamsMessagingPolicy, TeamsMobilityPolicy, TeamsRoomVideoTeleConferencingPolicy, TeamsShiftsPolicy, TeamsUpdateManagementPolicy, TeamsVdiPolicy, TeamsVideoInteropServicePolicy, TenantDialPlan, ExternalAccessPolicy, TeamsAppSetupPolicy, TeamsCallingPolicy, TeamsEventsPolicy, TeamsMeetingBrandingPolicy, TeamsMeetingTemplatePermissionPolicy, TeamsVerticalPackagePolicy |
| PolicyName | Write | String | Teams PolicyName. The name of the policy to be assigned. | |
| Priority | Write | String | Teams Priority. The rank of the policy assignment, relative to other group policy assignments for the same policy type | |
| Ensure | Write | String | Present ensures the group policy assignment exists, absent ensures it is removed. | Present, Absent |
| Credential | Write | PSCredential | Credentials of the Teams Admin | |
| ApplicationId | Write | String | Id of the Azure Active Directory application to authenticate with. | |
| TenantId | Write | String | Id of the Azure Active Directory tenant used for authentication. | |
| CertificateThumbprint | Write | String | Thumbprint of the Azure Active Directory application's authentication certificate to use for authentication. | |
| ManagedIdentity | Write | Boolean | Managed ID being used for authentication. | |
| AccessTokens | Write | StringArray[] | Access token used for authentication. |
Description¶
This resource is used to assign Teams policy to a specified group
Permissions¶
Microsoft Graph¶
To authenticate with the Microsoft Graph API, this resource required the following permissions:
Delegated permissions¶
-
Read
- None
-
Update
- None
Application permissions¶
-
Read
- Organization.Read.All
-
Update
- Organization.Read.All
Examples¶
Example 1¶
This examples configure a TeamsGroupPolicyAssignment.
Configuration Example
{
param
(
[Parameter(Mandatory = $true)]
[PSCredential]
$Credscredential
)
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{
TeamsGroupPolicyAssignment 'TeamsGroupPolicyAssignment'
{
Ensure = 'Present'
GroupDisplayname = 'SecGroup'
GroupId = ''
PolicyName = 'AllowCalling'
PolicyType = 'TeamsCallingPolicy'
Priority = 1
Credential = $Credscredential
}
}
}