Get-CsTeamsUpgradeStatus

Returns information related to the Microsoft-driven automated upgrade status from Skype for Business Online to Teams.

Syntax

Get-CsTeamsUpgradeStatus
   [-Tenant <Guid>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-CsTeamsUpgradeStatus
   [-Tenant <Guid>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

TeamsUpgradeStatus is used to check the status of customers eligible for Microsoft-driven automated upgrade of Skype for Business Online to Teams.

You can also find more guidance here: Getting started with your Microsoft Teams upgrade.

Examples

Example 1: The below example shows an example of TeamsUpgradeStatus with the tenant being scheduled for Microsoft-driven automated upgrade.

Note

The PowerShell results get populated at the same time upgrade notification is sent and may be null if the tenant is not yet notified.

PS C:\> Get-CsTeamsUpgradeStatus

TenantId             : ca573b31-a0db-4185-951e-3af848668397
State                : ScheduledForUpgrade
OptInEligibleDate    : 2018-04-12 18:06:36Z
UpgradeScheduledDate : 2018-06-15 00:00:00Z
UserNotificationDate : 2018-07-05 00:00:00Z
UpgradeDate          : 2018-07-10 00:00:00Z
LastStateChangeDate  : 2018-06-06 22:52:21Z

For more information on the results from the above example please reference the table below:

  • State: Tenant is scheduled to be upgraded via automated upgrade on the date returned.
  • OptInEligbleDate: Tenant is OptInEligible since 2018-04-12 18:06:36Z. (tenant admin can upgrade users on own since 2018-04-12 18:06:36Z)
  • UpgradeScheduledDate: Tenant's upgrade is/was scheduled to start at 2018-06-15 00:00:00Z. (When the tenant was first notified of the upgrade via the M365 Message Center)
  • UserNotificationDate: Tenant's end users will be/were notified starting 2018-07-05 00:00:00Z via SfB Client.
  • UpgradeDate: Tenant will be/was upgraded by Microsoft at 2018-07-10 00:00:00Z
  • LastStateChangeDate: Tenant's state was last changed at 2018-06-06 22:52:21Z.

For more information on the various upgrade "States" please reference the table below:

  • Null - Tenant isn't yet in the automated upgrade system.
  • OptInEligible - Tenant will be invited to a Microsoft driven upgrade at some point in the future.
  • ScheduledForUpgrade - Tenant is scheduled to be upgraded via automated upgrade on the date returned. This refers to the date that the tenant was first scheduled. Admins who click the Postpone button in the Teams Admin Portal will see the UpgradeDate move out 30 days but will not see a change in the Upgrade ScheduledDate field nor the OptInEligibleDate field.
  • Upgraded - Date that Tenant will be or has been upgraded.
  • Exempt - Tenant is exempt from Microsoft driven upgrade currently.

Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

-Tenant

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

Inputs

None

Outputs

None