Edit

Share via

New-CsTeamsUpdateManagementPolicy

Module:
MicrosoftTeams PowerShell module

Use this cmdlet to create Teams Update Management policy.

Syntax

Default (Default) 

New-CsTeamsUpdateManagementPolicy

    [-DisabledInProductMessages <System.Management.Automation.PSListModifier`1[System.String]>]
    [-Description <String>]
    [-AllowManagedUpdates <Boolean>]
    [-AllowPreview <Boolean>]
    [-UpdateDayOfWeek <Int64>]
    [-UpdateTime <String>]
    [-UpdateTimeOfDay <DateTime>]
    [-AllowPublicPreview <String>]
    [-AllowPrivatePreview <AllowPrivatePreview>]
    [-UseNewTeamsClient <String>]
    [-BlockLegacyAuthorization <Boolean>]
    [-Identity] <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Teams Update Management Policy allows admins to specify if a given user is enabled to preview features in Teams.

This cmdlet can be used to create a new policy to manage the visibility of some Teams in-product messages. Executing the cmdlet will suppress the corresponding category of messages from appearing for the specified user group.

Examples

Example 1

PS C:\> New-CsTeamsUpdateManagementPolicy -Identity "Campaign Policy" -DisabledInProductMessages @("91382d07-8b89-444c-bbcb-cfe43133af33")

Disable the in-product messages with the category "What's New".

Parameters

-AllowManagedUpdates

Enables/Disables managed updates for the user.

Parameter properties

Type:Boolean
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

-AllowPreview

Indicates whether all feature flags are switched on or off. Can be set only when AllowManagedUpdates is set to True.

Parameter properties

Type:Boolean
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

-AllowPrivatePreview

This setting will allow admins to allow users in their tenant to opt in to Private Preview. If it is Disabled, then users will not be able to opt in and the ring switcher UI will be hidden in the Desktop Client. If it is Enabled, then users will be able to opt in and the ring switcher UI will be available in the Desktop Client. If it is Forced, then users will be switched to Private Preview.

Parameter properties

Type:AllowPrivatePreview
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

-AllowPublicPreview

This setting will allow admins to allow users in their tenant to opt in to Public Preview. If it is Disabled, then users will not be able to opt in and the ring switcher UI will be hidden in the Desktop Client. If it is Enabled, then users will be able to opt in and the ring switcher UI will be available in the Desktop Client. If it is FollowOfficePreview, then users will not be able to opt in and instead follow their Office channel, and be switched to Public Preview if their Office channel is CC (Preview). The ring switcher UI will be hidden in the Desktop Client. This is not applicable to the Web Client. If it is Forced, then users will be switched to Public Preview.

Parameter properties

Type:String
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

-BlockLegacyAuthorization

This setting will force Teams clients to enforce session revocation for core Messaging and Calling/Meeting scenarios. If turned ON, session revocation will be enforced for calls, chats and meetings for opted-in users. If turned OFF, session revocation will not be enforced for calls, chats and meetings for opted-in users.

Parameter properties

Type:Boolean
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

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

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

Parameter sets

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

-Description

Enables administrators to provide explanatory text about the policy. For example, the Description might indicate the users the policy should be assigned to.

Parameter properties

Type:String
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

-DisabledInProductMessages

List of IDs of the categories of the in-product messages that will be disabled. You can choose one of the categories from this table:

ID Campaign Category
91382d07-8b89-444c-bbcb-cfe43133af33 What's New
edf2633e-9827-44de-b34c-8b8b9717e84c Conferences

Parameter properties

Type:

System.Management.Automation.PSListModifier`1[System.String]

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

-Force

Suppress all non-fatal errors.

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

-Identity

A unique identifier.

Parameter properties

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

Parameter sets

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

-OCDIRedirect

This setting controls whether users are redirected from teams.microsoft.com to the unified domain teams.cloud.microsoft. Possible values are:

  • Microsoft Default, Microsoft will manage redirection behavior. If no explicit admin configuration is set, users may be redirected automatically.
  • Disabled, Users will remain on teams.microsoft.com. Use this if your organization's apps are incompatible with the unified domain.
  • Enabled, Users will be redirected to teams.cloud.microsoft. Use this only if your organization had previously opted out of redirection and now wants to opt back in.

Parameter properties

Type:String
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

-UpdateDayOfWeek

Machine local day. 0-6(Sun-Sat) Can be set only when AllowManagedUpdates is set to True.

Parameter properties

Type:Int64
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

-UpdateTime

Machine local time in HH:MM format. Can be set only when AllowManagedUpdates is set to True.

Parameter properties

Type:String
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

-UpdateTimeOfDay

Machine local time. Can be set only when AllowManagedUpdates is set to True

Parameter properties

Type:DateTime
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

-UseNewTeamsClient

This setting will enable admins to show or hide which users see the Teams preview toggle on the current Teams client. If it is AdminDisabled, then users will not be able to see the Teams preview toggle in the Desktop Client. If it is UserChoice, then users will be able to see the Teams preview toggle in the Desktop Client. If it is MicrosoftChoice, then Microsoft will configure/ manage whether user sees or does not see this feature if the admin has set nothing. If it is NewTeamsAsDefault, then New Teams will be default for users, and they will be able to switch back to Classic Teams via the toggle in the Desktop Client. If it is NewTeamsOnly, then New Teams will be the only Teams client installed for users.

Parameter properties

Type:String
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

-WhatIf

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

Parameter properties

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

Parameter sets

(All)
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

None

Outputs

TeamsUpdateManagementPolicy.Cmdlets.TeamsUpdateManagementPolicy