How to Change Office 365 Update Channel with SCCM Run Script

4
Change Office 365 Update Channel Home

My name is Sharad Singh, and I have more 15 years of experience in IT and SCCM technologies, MS Intune. This post is my first one here in this blog! In this post, I will provide you a most straightforward way to Change Office 365 Update Channel for all your SCCM managed devices.

Introduction

Recently I was asked to find out how many devices on the Office 365 ProPlus monthly channel and then switch those devices to Semi-annual channel. To change office 365 between channel is very easy via SCCM Run Script feature.

  1. How many clients on the Office 365 ProPlus monthly channel?
  2. Switch Office 365 ProPlus clients to Semi-annual channel with SCCM Run Script

I want to share a few steps; you can create any PowerShell script and deploy that to SCCM managed devices. I would also like to take advantage of real-time reporting capabilities of SCCM Run a Script features for online SCCM client devices.

How to Find Out SCCM Client Devices with Office 365 Monthly Update Channel

You can identify the Office 365 channels easily with their CDNBaseUrl value in the registry. There are two methods to find out the Windows devices which are running Office 365 monthly update channel.

  1. You can launch the SCCM CMPivot tool from SCCM Console
    • Run a Live query to find out the registry values of Online machines.
    • Create a collection from the result of SCCM CMPivot live query (I will cover the details in the next post).
  2. Create a Collection with SCCM Collection Query (WQL – the old school). The details are provided in the below paragraph.

NOTE! – CDNBaseUrl for Office 365 monthly channel is the following value http://officecdn.microsoft.com/pr/492350f6-3a01-4f97-b9c0-c7c6ddf67d60

The CDNBaseUrl can be found in the registry on every computer where Office 365 ProPlus is installed.

HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration\CDNBaseUrl

Following collection query can be used for identifying how many clients you have on the monthly channel. I would recommend creating an SCCM dynamic collection using the following blog post.

NOTE!Learn How to Create SCCM Dynamic Collection and Dynamic WQL Query?

select SMS_R_SYSTEM.ResourceID,SMS_R_SYSTEM.ResourceType,SMS_R_SYSTEM.Name,SMS_R_SYSTEM.SMSUniqueIdentifier,SMS_R_SYSTEM.ResourceDomainORWorkgroup,SMS_R_SYSTEM.Client from SMS_R_System inner join SMS_G_System_OFFICE365PROPLUSCONFIGURATIONS on SMS_G_System_OFFICE365PROPLUSCONFIGURATIONS.ResourceID = SMS_R_System.ResourceId where SMS_G_System_OFFICE365PROPLUSCONFIGURATIONS.CDNBaseUrl = "http://officecdn.microsoft.com/pr/492350f6-3a01-4f97-b9c0-c7c6ddf67d60"

How to Change Office 365 Update Channel using SCCM Run Script?

Now that you know the machines you want to target and change the Office 365 ProPlus update channel to semi-annual channel. The next step is to create a PowerShell script and deploy it on client machines.

NOTE! – The devices should meet the following prerequisites to run the PowerShell scripts using SCCM Run Script feature.

  • The SCCM client device must be running PowerShell version 3.0 or later
  • The SCCM client should be SCCM 1706 client version or later

The following steps will help you to find out the machines which are running with Office 365 monthly update channel.

  • Navigate via SCCM console, click Software Library workspace
  • From the Software Library workspace, click Scripts.
  • On the Home tab, in the Create group, click Create Script.
  • On the Script page of the Create Script wizard, configure the following settings:
    • Enter the Script Name – “Switch Office 365 monthly channel to semi-annual channel.”
    • Select Script Language as PowerShell Script
    • Paste the following “change Office 365 Update Channel” script
    • Click Next
Change Office 365 Update Channel using SCCM Run Script
Change Office 365 Update Channel using SCCM Run Script
$UpdateChannel = "http://officecdn.microsoft.com/pr/7ffbc6bf-bc32-4f92-8982-f9dd17fd3114" 
$CTRConfigurationPath = "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" 
$CDNBaseUrl = Get-ItemProperty -Path $CTRConfigurationPath -Name "CDNBaseUrl" -ErrorAction SilentlyContinue | Select-Object -ExpandProperty "CDNBaseUrl" 
if ($CDNBaseUrl -ne $null) { 
    if ($CDNBaseUrl -notmatch $UpdateChannel) { 
        # Set new update channel 
        Set-ItemProperty -Path $CTRConfigurationPath -Name "CDNBaseUrl" -Value $UpdateChannel -Force 
 
        # Trigger hardware inventory 
        Invoke-WmiMethod -Namespace "root\ccm" -Class "SMS_Client" -Name "TriggerSchedule" -ArgumentList "{00000000-0000-0000-0000-000000000001}" 
    } 
}
  • [Optional Step] If you want then you can import (click on IMPORT button) the PowerShell script from your computer.
Change Office 365 Update Channel using SCCM Run Script

SCCM Change Office 365 Update Channel using SCCM Run Script
  • Click on Finish button to complete the wizard.

How to Approve Change Office 365 Update Channel Script

Now your script is ready and waiting for approval, ask your SCCM administrator to approve the script. Otherwise, you can do it yourself using the following guide.

NOTE! – Do you want to learn the process of SCCM script approvals? You can refer to the following blog post. Learn How to Approve or Deny Script – SCCM PowerShell Script.

Switch Office 365 Update Channel using SCCM Run Script
Switch Office 365 Update Channel using SCCM Run Script

Once the “Switch Office 365 monthly channel to semi-annual channel” script to change Office 365 update channel is approved, you can either run a script to the device(s) or device collection.

NOTE! – I would recommend testing the script with one device first. Once you can confirm the script is completed successfully. Hopefully, the script was able to change from Office 365 Monthly Channel to Semi-annual Channel.

You can deploy Switch Office 365 Update Channel Script to change the office 365 update channel.

  • Right click on computer name (or Device Collection) from Assets and Compliance workspace.
  • Select the PowerShell script “Switch Office 365 monthly channel to semi-annual channel”.
  • Click Next and Next.
Change Office 365 Update Channel using SCCM Run Script
  • You can see the script is completed successfully. More details available in a video guide.
How to Change Office 365 Update Channel with SCCM Run Script 2

How to Verify Office 365 Update Channel Change

There are many ways to check whether the Office 365 ProPlus update channel is changed or not. But, I’m going to provide one manual method and an automated method.

Manual Verification

  • You can go to the computer and open the registry
    HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration\CDNBaseUrl
  • You can find the CDNBaseURL value is changed to semi-annual update channel http://officecdn.microsoft.com/pr/7ffbc6bf-bc32-4f92-8982-f9dd17fd3114

Automated Verification of Office 365 Update Channel Change

Method #1

  • You can launch the SCCM CMPivot from the console
  • Run the CMPivot query to find out the value of the registry for that machine

Method #2

You can monitor the SCCM Update Office 365 Update Channel Script execution status. It’s easy to monitor the script results in the latest versions of SCCM.

  • Open SCCM console and Navigate to Monitoring
  • Click on Script Status node
  • Select the script “Switch Office 365 monthly channel to semi-annual channel
  • Click on Show Status ribbon icon
  • [Optional] – You can go into the log file on the SCCM client machine and confirm the execution of the script.
    • CCMNotificationAgent.log
    • Script.log

Resources

4 COMMENTS

  1. Thanks for sharing the knowledge.

    Will this also downgrade the Office install on the machine from the latest monthly version (1903) to the latest semi-annual version (1808)? How does the update process work after this change if the script doesn’t change the installed version? Does it just leave the monthly version on there unpatched until an update for the semi-annual channel is newer?

    Thanks.

    • it will not downgrade the office, neither update automatically, you have to update the office by clicking manually update or you have to use the upgrade through SCCM if upgrade is managed by SCCM.
      only higher build versions will be installed.

  2. Great artikel.

    I did this with a configuration baseline and a config item (change the regkey). Works great. But my question is when the regkey is changed Word pro plus still shows that it is in a different (wrong) channel. The device also won’t get the correct updates installed. When going to account and see what channel is set.

    When will also the office pro plus change this setting and when will SUP (sccm) see that that device needs the different updates of that channel? Or do i just have to wait…

    I also saw that there is a other reg_sz key with this value: UpdateChannel. This doesn’t have to be changed?

    • Yes, if you want to get the update from cloud or from SCCM office 365 update, then you need to change the value of update channel also, then your computer will be scan for the updates based on the channel, otherwise it will be on channel which you changed but wont get updates,

LEAVE A REPLY

Please enter your comment!
Please enter your name here

This site uses Akismet to reduce spam. Learn how your comment data is processed.