Grant-CsTeamsMobilityPolicy

Reference

Module:: MicrosoftTeamsPowerShell

Applies to:: Microsoft Teams

The TeamsMobilityPolicy allows Admins to control Teams mobile usage for users.

Syntax

Grant-CsTeamsMobilityPolicy
     [[-Identity] <String>]
     [-PassThru]
     [[-PolicyName] <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Grant-CsTeamsMobilityPolicy
     [-PassThru]
     [[-PolicyName] <String>]
     [-Global]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Grant-CsTeamsMobilityPolicy
     [-PassThru]
     [[-PolicyName] <String>]
     -Group <String>
     [-Rank <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Assigns a teams mobility policy at the per-user scope.

The Grant-CsTeamsMobilityPolicy cmdlet lets an Admin assign a custom teams mobility policy to a user.

Examples

Example 1

PS C:\>  Grant-CsTeamsMobilityPolicy -PolicyName SalesPolicy -Identity "Ken Myer"

Assigns a custom policy "Sales Policy" to the user "Ken Myer"

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Global

When you use this cmdlet without specifying a user identity, the policy applies to all users in your tenant. To skip a warning when you do this operation, specify "-Global".

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Group

Specifies the group used for the group policy assignment.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

The User Id of the user to whom the policy is being assigned.

Type:	UserIdParameter
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

Enables you to pass a user object through the pipeline that represents the user account being assigned the Teams call hold policy.

By default, the cmdlet does not pass objects through the pipeline.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PolicyName

The name of the custom policy that is being assigned to the user. To remove a specific assignment and fall back to the Global policy, you can assign $Null.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Rank

The rank of the policy assignment, relative to other group policy assignments for the same policy type.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.Rtc.Management.AD.UserIdParameter

Outputs

System.Object