Grant-MSTGroupPolicyPackageAssignment

Teams: Assign a policy package to a group

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [string[]]$GroupId,
    [Parameter(Mandatory = $true)]
    [string]$PackageName,
    [string]$PolicyRankings
)

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

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

        $result = Grant-CsGroupPolicyPackageAssignment @cmdArgs

        [PSCustomObject]@{
            Timestamp   = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
            GroupId     = ($GroupId -join ', ')
            PackageName = $PackageName
            Status      = if ($null -eq $result) { 'Policy package assigned' } else { $result.ToString() }
        }
    }
    catch { throw }
}

Customize

GroupId string

One or more group IDs in the tenant

PackageName string

The name of the policy package to apply

PolicyRankings string

Policy rankings for each of the policy types in the package