Office 365: Using PowerShell to Detect Service Upgrade Status

  • Article

If you are an Office 365 Company Administrator, you will receive an email notification once your tenant has been scheduled for a service upgrade. This email is typically sent several weeks before the upgrade is scheduled to take place.

In case you have missed this email notification, you can utilize the Windows Azure Active Directory Module for Windows PowerShell to detect if your tenant has been scheduled for upgrade, and also detect if your tenant has already been upgraded.

Note: This method does not show the exact date of the scheduled service upgrade.

 

Steps

  1. Install  Windows Azure Active Directory Module for Windows PowerShell

  2. Launch Windows Azure Active Directory Module for Windows PowerShell

  3. Execute the following commands:

    Import-Module MSOnline
    Connect-MsolService
     (type your Company Administrator credentials for the tenant you would like to check)
    (Get-MsolCompanyInformation).CompanyTags
    X

  4. In the output, look for the following:

    Value in Output

    Description

    o365.microsoft.com/14to15UpgradeCompletedDate

    If the tenant has been upgraded, this attribute will contain the date of the upgrade

    o365.microsoft.com/version

    The current version of the Office 365 service is shown (i.e. - 15)

    o365.microsoft.com/14to15UpgradeScheduled

    If the tenant has been scheduled for upgrade, this attribute will equal 'True'

Note: If you don’t see any of the properties shown in the table above, that means you haven’t been scheduled yet.