Commands › Microsoft Teams
Invoke-StartDirectToGroupAssignmentMigration
As an admin, you can trigger a new direct assignments to group policy assignments migration.
Quick start script
# Invoke-StartDirectToGroupAssignmentMigration — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId
# 2. Run and inspect
Invoke-StartDirectToGroupAssignmentMigration -Authority <String> -GroupId <Guid> -PolicyName <String> | Format-List
# 3. Export for evidence / drift tracking
Invoke-StartDirectToGroupAssignmentMigration | Export-Clixml .\StartDirectToGroupAssignmentMigration-$(Get-Date -Format yyyyMMdd).xmlSyntax
Invoke-StartDirectToGroupAssignmentMigration -Authority <String> -PolicyType <String> -PolicyName <String>
-GroupId <Guid> [-AllowNonEmptyGroup <Boolean>] [<CommonParameters>]Parameters (5)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -AllowNonEmptyGroup | Boolean | Flag to know if the process should continue or not when the group provided already have an active group policy assignment. | |
| -Authority | String | yes | The authority (issuer) of the policy. |
| -GroupId | Guid | yes | The target group ID. |
| -PolicyName | String | yes | The name of the policy. |
| -PolicyType | String | yes | The type of the policy. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.