diff --git a/teams/teams-ps/MicrosoftTeams/Get-DirectToGroupAssignmentsMigrationStatus.md b/teams/teams-ps/MicrosoftTeams/Get-DirectToGroupAssignmentsMigrationStatus.md new file mode 100644 index 0000000000..d4e64c65d6 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-DirectToGroupAssignmentsMigrationStatus.md @@ -0,0 +1,71 @@ +--- +applicable: Microsoft Teams +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml +Module Name: MicrosoftTeams +author: emartinezrod +ms.author: emartinezrod +manager: ganesh +online version: +schema: 2.0.0 +title: Get-DirectToGroupAssignmentsMigrationStatus +--- + +# Get-DirectToGroupAssignmentsMigrationStatus + +## SYNOPSIS +As an admin, you can get the status of any direct assignments to group policy assignments migration. + +## SYNTAX +``` +Get-DirectToGroupAssignmentsMigrationStatus [-MigrationEventId ] + [] +``` + +## DESCRIPTION +As an admin, you can get the status of all the direct assignments to group policy assignments migrations completed or in progress in the tenant. Or you can provide an specific migration id to know the status of one in particular. + +**This is only applicable for tenants who have activated the new features related to group policy assignment adoption.** + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-DirectToGroupAssignmentsMigrationStatus +``` + +In this example, the Get-DirectToGroupAssignmentsMigrationStatus cmdlet is used to get the status of all the direct assignments to group policy assignments migrations completed or in progress in the tenant. + +### Example 2 +```powershell +PS C:\> Get-DirectToGroupAssignmentsMigrationStatus -MigrationEventId 42ed6fb9-65c7-42de-abda-7492bfe2d616 +``` + +In this example, the Get-DirectToGroupAssignmentsMigrationStatus cmdlet is used to get the status of the direct assignments to group policy assignments migration with the event id 42ed6fb9-65c7-42de-abda-7492bfe2d616. + +## PARAMETERS + +### -MigrationEventId +Migration event id from which want to know the status. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/teams/teams-ps/MicrosoftTeams/Get-GroupAssignmentRecommendationsPerPolicyName.md b/teams/teams-ps/MicrosoftTeams/Get-GroupAssignmentRecommendationsPerPolicyName.md new file mode 100644 index 0000000000..c2b268720e --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-GroupAssignmentRecommendationsPerPolicyName.md @@ -0,0 +1,101 @@ +--- +applicable: Microsoft Teams +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml +Module Name: MicrosoftTeams +author: emartinezrod +ms.author: emartinezrod +manager: ganesh +online version: +schema: 2.0.0 +title: Get-GroupAssignmentRecommendationsPerPolicyName +--- + +# Get-GroupAssignmentRecommendationsPerPolicyName + +## SYNOPSIS +As an admin, you can get group policy assignments recommendations based on the existing direct assignments for a policy document. + +## SYNTAX +``` +Get-GroupAssignmentRecommendationsPerPolicyName -EntityType -PolicyType + [-GroupThreshold ] [] +``` + +## DESCRIPTION +As an admin, you can get a list of possible group policy assignments that can be created based on the existing direct assignments for a policy document provided, grouping by policy instance name. + +**This is only applicable for tenants who have activated the new features related to group policy assignment adoption.** + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-GroupAssignmentRecommendationsPerPolicyName -EntityType User -PolicyType TeamsCallingPolicy +``` + +In this example, the Get-GroupAssignmentRecommendationsPerPolicyName cmdlet is used to get all the possible group policy assignments that can be created for the policy type TeamsCallingPolicy and entity type User. In this case the group threshold is not provided so the default will be 500, which means that all the recommendations will have at least 500 users. This threshold can change based on admin preferences. + +### Example 2 +```powershell +PS C:\> Get-GroupAssignmentRecommendationsPerPolicyName -EntityType User -GroupThreshold 1 -PolicyType TeamsCallingPolicy +``` + +In this example, the Get-GroupAssignmentRecommendationsPerPolicyName cmdlet is used to get all the possible group policy assignments that can be created for the policy type TeamsCallingPolicy, entity type User and providing a group threshold of 1, which means that all the recommendations will have at least 1 user. This threshold can change based on admin preferences. + +## PARAMETERS + +### -EntityType +Entity type from which the cmdlet will provide the recommendations. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -GroupThreshold +Group threshold used to define the minimum number of users per group that will be recommended. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyType +Policy type of the instance from which the cmdlet will provide the recommendations. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/teams/teams-ps/MicrosoftTeams/Get-GroupAssignmentRecommendationsPerPolicyType.md b/teams/teams-ps/MicrosoftTeams/Get-GroupAssignmentRecommendationsPerPolicyType.md new file mode 100644 index 0000000000..8c358822a9 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-GroupAssignmentRecommendationsPerPolicyType.md @@ -0,0 +1,86 @@ +--- +applicable: Microsoft Teams +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml +Module Name: MicrosoftTeams +author: emartinezrod +ms.author: emartinezrod +manager: ganesh +online version: +schema: 2.0.0 +title: Get-GroupAssignmentRecommendationsPerPolicyType +--- + +# Get-GroupAssignmentRecommendationsPerPolicyType + +## SYNOPSIS +As an admin, you can get group policy assignments recommendations based on the existing direct assignments for a policy type. + +## SYNTAX +``` +Get-GroupAssignmentRecommendationsPerPolicyType -EntityType [-GroupThreshold ] + [] +``` + +## DESCRIPTION +As an admin, you can get a list of possible group policy assignments that can be created based on the existing direct assignments for a policy document provided, grouping by policy instance type. + +**This is only applicable for tenants who have activated the new features related to group policy assignment adoption.** + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-GroupAssignmentRecommendationsPerPolicyType -EntityType User +``` + +In this example, the Get-GroupAssignmentRecommendationsPerPolicyType cmdlet is used to get all the possible group policy assignments that can be created for the entity type User. In this case the group threshold is not provided so the default will be 500, which means that all the recommendations will have at least 500 users. This threshold can change based on admin preferences. + +### Example 2 +```powershell +PS C:\> Get-GroupAssignmentRecommendationsPerPolicyType -EntityType User -GroupThreshold 1 +``` + +In this example, the Get-GroupAssignmentRecommendationsPerPolicyType cmdlet is used to get all the possible group policy assignments that can be created for the entity type User and providing a group threshold of 1, which means that all the recommendations will have at least 1 user. This threshold can change based on admin preferences. + +## PARAMETERS + +### -EntityType +Entity type from which the cmdlet will provide the recommendations. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -GroupThreshold +Group threshold used to define the minimum number of users per group that will be recommended. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/teams/teams-ps/MicrosoftTeams/Get-GroupPolicyAssignmentConflict.md b/teams/teams-ps/MicrosoftTeams/Get-GroupPolicyAssignmentConflict.md new file mode 100644 index 0000000000..466c55ef11 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-GroupPolicyAssignmentConflict.md @@ -0,0 +1,80 @@ +--- +applicable: Microsoft Teams +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml +Module Name: MicrosoftTeams +author: emartinezrod +ms.author: emartinezrod +manager: ganesh +online version: +schema: 2.0.0 +title: Get-GroupPolicyAssignmentConflict +--- + +# Get-GroupPolicyAssignmentConflict + +## SYNOPSIS +As an admin, you can get the existing conflicts for a particular group policy assignments which causes it not to be effective for some users. + +## SYNTAX +``` +Get-GroupPolicyAssignmentConflict -GroupId -PolicyType + [] +``` + +## DESCRIPTION +As an admin, you can get the existing conflicts for a particular group policy assignments which causes it not to be effective for some users, providing the group id and policy type of the assignment. This will return a list of users in where the group policy assignment is not effective due a direct assignment or other group policy assignment that is taking effect on it. + +**This is only applicable for tenants who have activated the new features related to group policy assignment adoption.** + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-GroupPolicyAssignmentConflict -GroupId cde9a331-5bf8-415c-990c-19838b0d898a -PolicyType TeamsCallingPolicy +``` + +In this example, the Get-GroupPolicyAssignmentConflict cmdlet is used to get all the possible conflicts that the group policy assignment in TeamsCallingPolicy applied for group cde9a331-5bf8-415c-990c-19838b0d898a could have with others assignments. + +## PARAMETERS + +### -GroupId +Group id of the group policy assignment from which the cmdlet will look for conflicts. + + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyType +Policy type of the group policy assignment from which the cmdlet will look for conflicts. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/teams/teams-ps/MicrosoftTeams/Invoke-ClearDirectToGroupAssignmentMigration.md b/teams/teams-ps/MicrosoftTeams/Invoke-ClearDirectToGroupAssignmentMigration.md new file mode 100644 index 0000000000..4b76be3b6a --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Invoke-ClearDirectToGroupAssignmentMigration.md @@ -0,0 +1,109 @@ +--- +applicable: Microsoft Teams +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml +Module Name: MicrosoftTeams +author: emartinezrod +ms.author: emartinezrod +manager: ganesh +online version: +schema: 2.0.0 +title: Invoke-ClearDirectToGroupAssignmentMigration +--- + +# Invoke-ClearDirectToGroupAssignmentMigration + +## SYNOPSIS +As an admin, you can trigger a new direct assignments to group policy assignments cleanup. + +## SYNTAX +``` +Invoke-ClearDirectToGroupAssignmentMigration -Authority -PolicyType -PolicyName + -GroupId [] +``` + +## DESCRIPTION +As an admin, you can trigger a new direct assignments to group policy assignments cleanup for a specific authority, instance document and group id. The cleanup will be automatic and will clean all direct assignments with the provided parameters. + +**This is only applicable for tenants who have activated the new features related to group policy assignment adoption.** + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Invoke-clearDirectToGroupAssignmentMigration -Authority Tenant -PolicyType TeamsCallingPolicy -PolicyName Test-Gpa-Adoption-Policy-2 -GroupId cde9a331-5bf8-415c-990c-19838b0d898c +``` + +In this example, the Invoke-clearDirectToGroupAssignmentMigration cmdlet is used to trigger the direct assignment to group policy assignment cleanup for the instance document with policy type TeamsCallingPolicy and name Test-Gpa-Adoption-Policy-2 which will clean all direct assignments with the provided parameters. + +## PARAMETERS + +### -Authority +The authority (issuer) of the policy. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -GroupId +The target group ID. + +```yaml +Type: Guid +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyName +The name of the policy. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyType +The type of the policy. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/teams/teams-ps/MicrosoftTeams/Invoke-StartDirectToGroupAssignmentMigration.md b/teams/teams-ps/MicrosoftTeams/Invoke-StartDirectToGroupAssignmentMigration.md new file mode 100644 index 0000000000..d0c0778965 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Invoke-StartDirectToGroupAssignmentMigration.md @@ -0,0 +1,131 @@ +--- +applicable: Microsoft Teams +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml +Module Name: MicrosoftTeams +author: emartinezrod +ms.author: emartinezrod +manager: ganesh +online version: +schema: 2.0.0 +title: Invoke-StartDirectToGroupAssignmentMigration +--- + +# Invoke-StartDirectToGroupAssignmentMigration + +## SYNOPSIS +As an admin, you can trigger a new direct assignments to group policy assignments migration. + +## SYNTAX +``` +Invoke-StartDirectToGroupAssignmentMigration -Authority -PolicyType -PolicyName + -GroupId [-AllowNonEmptyGroup ] [] +``` + +## DESCRIPTION +As an admin, you can trigger a new direct assignments to group policy assignments migration for a specific authority, instance document and group id. The migration will be automatic and will move all the users that have the direct assignment with the provided parameters to the group provided and will apply the correct group policy assignment, removing after all the exiting direct assignments to avoid any conflict. At the end the behavior will be the same one but the admin will have now to manage only a group instead of a bunch of direct assignments. + +**This is only applicable for tenants who have activated the new features related to group policy assignment adoption.** + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Invoke-startDirectToGroupAssignmentMigration -Authority Tenant -PolicyType TeamsCallingPolicy -PolicyName Test-Gpa-Adoption-Policy-2 -GroupId cde9a331-5bf8-415c-990c-19838b0d898c +``` + +In this example, the Invoke-startDirectToGroupAssignmentMigration cmdlet is used to trigger the direct assignment to group policy assignment migration for the instance document with policy type TeamsCallingPolicy and name Test-Gpa-Adoption-Policy-2 to the group cde9a331-5bf8-415c-990c-19838b0d898c. In this case the flag allowNonEmptyGroup is not provided and the default will be false which means if the group provided already have an active group policy assignment the operation wont be trigger. + +### Example 2 +```powershell +PS C:\> Invoke-startDirectToGroupAssignmentMigration -Authority Tenant -PolicyType TeamsCallingPolicy -PolicyName Test-Gpa-Adoption-Policy-2 -GroupId cde9a331-5bf8-415c-990c-19838b0d898c -allowNonEmptyGroup $True +``` + +In this example, the Invoke-startDirectToGroupAssignmentMigration cmdlet is used to trigger the direct assignment to group policy assignment migration for the instance document with policy type TeamsCallingPolicy and name Test-Gpa-Adoption-Policy-2 to the group cde9a331-5bf8-415c-990c-19838b0d898c. In this case the flag allowNonEmptyGroup is provided which means even thought the group provided already have an active group policy assignment the operation will be trigger. + +## PARAMETERS + +### -AllowNonEmptyGroup +Flag to know if the process should continue or not when the group provided already have an active group policy assignment. + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Authority +The authority (issuer) of the policy. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -GroupId +The target group ID. + +```yaml +Type: Guid +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyName +The name of the policy. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -PolicyType +The type of the policy. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md index 65e03f63b4..df9481a55a 100644 --- a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md +++ b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md @@ -554,6 +554,18 @@ This cmdlet supports retrieving recommendations for which policy packages are be ### [Get-CsVideoInteropServiceProvider](Get-CsVideoInteropServiceProvider.md) Get information about the Cloud Video Interop for Teams. +### [Get-DirectToGroupAssignmentsMigrationStatus](Get-DirectToGroupAssignmentsMigrationStatus.md) +Get the status of any direct assignments to group policy assignments migration. + +### [Get-GroupAssignmentRecommendationsPerPolicyName](Get-GroupAssignmentRecommendationsPerPolicyName.md) +Get group policy assignments recommendations based on the existing direct assignments for a policy document. + +### [Get-GroupAssignmentRecommendationsPerPolicyType](Get-GroupAssignmentRecommendationsPerPolicyType.md) +Get group policy assignments recommendations based on the existing direct assignments for a policy type. + +### [Get-GroupPolicyAssignmentConflict](Get-GroupPolicyAssignmentConflict.md) +Get the existing conflicts for a particular group policy assignments which causes it not to be effective for some users. + ### [Get-M365TeamsApp](Get-M365TeamsApp.md) This cmdlet returns app availability and state for the Microsoft Teams app. @@ -749,6 +761,12 @@ Use Import-CsAutoAttendantHolidays cmdlet to import holiday schedules of an exis ### [Import-CsOnlineAudioFile](Import-CsOnlineAudioFile.md) Use the Import-CsOnlineAudioFile cmdlet to upload a new audio file. +### [Invoke-ClearDirectToGroupAssignmentMigration](Invoke-ClearDirectToGroupAssignmentMigration.md) +Trigger a new direct assignments to group policy assignments cleanup. + +### [Invoke-StartDirectToGroupAssignmentMigration](Invoke-StartDirectToGroupAssignmentMigration.md) +Trigger a new direct assignments to group policy assignments migration + ### [New-CsApplicationAccessPolicy](New-CsApplicationAccessPolicy.md) Creates a new application access policy. Application access policy contains a list of application (client) IDs.