Edit

Share via

Grant-CsTeamsUpdateManagementPolicy

Module:
MicrosoftTeams PowerShell module

Use this cmdlet to grant a specific Teams Update Management policy to a user.

Syntax

Identity (Default) 

Grant-CsTeamsUpdateManagementPolicy
    [[-Identity] <String>]
    [[-PolicyName] <String>]
    [-PassThru]
    [-MsftInternalProcessingMode <String>]
    [-ProgressAction <ActionPreference>]
    [<CommonParameters>]

GrantToTenant 

Grant-CsTeamsUpdateManagementPolicy
    [[-PolicyName] <String>]
    [-PassThru]
    [-MsftInternalProcessingMode <String>]
    [-Global]
    [-ProgressAction <ActionPreference>]
    [<CommonParameters>]

GrantToGroup 

Grant-CsTeamsUpdateManagementPolicy
    [[-PolicyName] <String>]
    [-Group] <String>
    [-PassThru]
    [-MsftInternalProcessingMode <String>]
    [-Rank <Int32>]
    [-ProgressAction <ActionPreference>]
    [<CommonParameters>]

Description

Grants a specific Teams Update Management policy to a user or sets a specific Teams Update Management policy as the new effective global policy.

Examples

Example 1

PS C:\> Grant-CsTeamsUpdateManagementPolicy -PolicyName "Campaign Policy" -Identity kenmyer@litwareinc.com

In this example, the policy "Campaign Policy" is granted to the user kenmyer@litwareinc.com.

Parameters

-Global

Use this parameter to make the specified policy in -PolicyName the new effective global policy.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

GrantToTenant
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Group

Specifies the group used for the group policy assignment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

GrantToGroup
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Indicates the identity of the user account the policy should be assigned to.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Identity
Position:0
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-PassThru

Including this parameter (which does not take a value) displays the user information when the cmdlet completes. Normally there is no output when this cmdlet is run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PolicyName

The identity of the policy to be granted.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Rank

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

GrantToGroup
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

System.String

Outputs

System.Object