New-MSTGroupPolicyAssignment

Teams: Assign a policy to a security group or distribution list

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [string]$GroupId,
    [Parameter(Mandatory = $true)]
    [ValidateSet('TeamsAppSetupPolicy','TeamsCallingPolicy','TeamsCallParkPolicy','TeamsChannelsPolicy','TeamsComplianceRecordingPolicy','TeamsEducationAssignmentsAppPolicy','TeamsMeetingBroadcastPolicy','TeamsMeetingPolicy','TeamsMessagingPolicy')]
    [string]$PolicyType,
    [Parameter(Mandatory = $true)]
    [string]$PolicyName,
    [int]$Rank
)

Process {
    try {
        [hashtable]$cmdArgs = @{'ErrorAction' = 'Stop'; 'GroupId' = $GroupId; 'PolicyType' = $PolicyType; 'PolicyName' = $PolicyName}

        if ($PSBoundParameters.ContainsKey('Rank')) {
            $cmdArgs.Add('Rank', $Rank)
        }

        $result = New-CsGroupPolicyAssignment @cmdArgs | Select-Object *

        if ($null -eq $result) {
            Write-Output "Group policy assigned"
            return
        }
        $result | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format 'yyyy-MM-dd HH:mm:ss') -PassThru -Force
    }
    catch { throw }
}

Customize

GroupId string

Object ID of the group

PolicyType string

The type of the policy

PolicyName string

The name of the policy to assign

Rank int

The rank of the policy assignment