Chocolatey Community Coffee Break

Join the Chocolatey Team on our regular monthly stream where we discuss all things Community, what we do, how you can get involved and answer your Chocolatey questions.

Learn More

Chocolatey Product Spotlight

Join the Chocolatey Team on our regular monthly stream where we put a spotlight on the most recent Chocolatey product releases. You'll have a chance to have your questions answered in a live Ask Me Anything format.

Learn More

Announcing Chocolatey Central Management 0.10.0

Livestream from
Thursday, 06 October 2022

We recently released our largest update to Chocolatey Central Management so far. Join Gary and Steph to find out more about Chocolatey Central Management and the new features and fixes we've added to this release.

Watch On-Demand
Chocolatey and Intune Overview

Webinar Replay from
Wednesday, 30 March 2022

At Chocolatey Software we strive for simple, and teaching others. Let us teach you just how simple it could be to keep your 3rd party applications updated across your devices, all with Intune!

Watch On-Demand
Chocolatey For Business. In Azure. In One Click.

Livestream from
Thursday, 9 June 2022

Join James and Josh to show you how you can get the Chocolatey For Business recommended infrastructure and workflow, created, in Azure, in around 20 minutes.

Watch On-Demand
The Future of Chocolatey CLI

Livestream from
Thursday, 04 August 2022

Join Paul and Gary to hear more about the plans for the Chocolatey CLI in the not so distant future. We'll talk about some cool new features, long term asks from Customers and Community and how you can get involved!

Watch On-Demand
Hacktoberfest Tuesdays 2022

Livestreams from
October 2022

For Hacktoberfest, Chocolatey ran a livestream every Tuesday! Re-watch Cory, James, Gary, and Rain as they share knowledge on how to contribute to open-source projects such as Chocolatey CLI.

Watch On-Demand
Chocolatey Product Spotlight: Chocolatey 1.2.0 and Chocolatey Licensed Extension 5.0.0

Livestream from
Thursday, 03 November 2022

Join Paul and Gary for this months Chocolatey product livestream where we look at the latest release of Chocolatey 1.2.0, Chocolatey Licensed Extension 5.0.0 and shine a spotlight on the new hook scripts functionality. This opens up so many possibilities for Chocolatey CLI users!

Watch On-Demand
Chocolatey Coding Livestream

Livestream from
Tuesday, 29 November 2022

Join Josh as he adds the ability to manage Chocolatey GUI config and features with the Chocolatey Ansible Collection.

Watch On-Demand
Introduction into Chocolatey with Veeam

Webinar from
Tuesday, 13 December 2022

Join Gary, Paul, and Maurice as they introduce and demonstrate how to use Chocolatey! Questions will be answered live in an Ask Me Anything format.

Watch On-Demand



Downloads of v 16731.20398:


Last Update:

22 Nov 2023

Package Maintainer(s):

Software Author(s):

  • Microsoft


Microsoft Office365Business Office 365 Bussines Microsoft365 admin

Office 365 Business

  • 1
  • 2
  • 3

16731.20398 | Updated: 22 Nov 2023



Downloads of v 16731.20398:



Software Author(s):

  • Microsoft

Office 365 Business 16731.20398

  • 1
  • 2
  • 3

This Package Contains an Exempted Check

Not All Tests Have Passed

Validation Testing Exemption for this package version only:

URLs work when going to them manually.

Verification Testing Exemption:

Install takes too long, times out test.


Scan Testing Successful:

No detections found in any package files

Learn More

Deployment Method: Individual Install, Upgrade, & Uninstall

To install Office 365 Business, run the following command from the command line or from PowerShell:


To upgrade Office 365 Business, run the following command from the command line or from PowerShell:


To uninstall Office 365 Business, run the following command from the command line or from PowerShell:


Deployment Method:


This applies to both open source and commercial editions of Chocolatey.

1. Enter Your Internal Repository Url

(this should look similar to

2. Setup Your Environment

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

2. Get the package into your environment

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Copy Your Script

choco upgrade office365business -y --source="'INTERNAL REPO URL'" [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:

choco upgrade office365business -y --source="'INTERNAL REPO URL'" 

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0

Exit $exitCode

- name: Install office365business
    name: office365business
    version: '16731.20398'
    state: present

See docs at

chocolatey_package 'office365business' do
  action    :install
  source   'INTERNAL REPO URL'
  version  '16731.20398'

See docs at

cChocoPackageInstaller office365business
    Name     = "office365business"
    Version  = "16731.20398"
    Source   = "INTERNAL REPO URL"

Requires cChoco DSC Resource. See docs at

package { 'office365business':
  ensure   => '16731.20398',
  provider => 'chocolatey',
  source   => 'INTERNAL REPO URL',

Requires Puppet Chocolatey Provider module. See docs at

4. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

Package Approved

This package was approved by moderator Windos on 28 Nov 2023.



Microsoft 365 (formerly Office 365) is a line of subscription services offered by Microsoft as part of the Microsoft Office product line. The brand encompasses plans that allow use of the Microsoft Office software suite over the life of the subscription, as well as cloud-based software as a service products for business environments, such as hosted Exchange Server, Skype for Business Server, and SharePoint, among others. All Microsoft 365 plans include automatic updates to their respective software at no additional charge, as opposed to conventional licenses for these programs—where new versions require purchase of a new license.

This package installs the Microsoft 365 Business Retail edition with the language and architecture (32/64 bits) matching the device if not specified otherwise on the parameters.


  • This installer will uninstall any other Office packages installed prior to installing this one to avoid possible errors during installation.
  • If you want to force the 32bit version on a 64bit Windows, use the choco --forcex86 parameter when installing the package.

Package installation defaults

By default, installation of this package:

  • Will uninstall other Microsoft 365 packages present on the device.
  • Will install with the matching the language of the operating system.
  • Will install the Microsoft 365 Business Retail product with all the default apps if not specified otherwise as a parameter.
  • Will set the release channel to Current.
  • Will enable auto-updates.

Package Parameters

  • /configpath - Allows you to specify a custom XML configuration for the installer which is present on the system.
  • /productid - Allows you to change the default product id to install from O365BusinessRetail to something else.
  • /exclude - Allows you to exclude some applications from the default product id you install.
  • /language - Allows you to specify a language different to the default one present on the device.
  • /updates - Enables auto-updates.
  • /eula - Automatically accepts EULA.


Installation without parameters with default values.

choco install office365business

Installation with parameters. Will select Microsoft 365 Home Premium retail edition in 32bits, only install Excel, Powerpoint and Word in French with updates disabled and EULA not accepted automatically.

 choco install office365business --forcex86 --params "'/productid:O365HomePremRetail /exclude:Access Groove Lync OneDrive OneNote Outlook Publisher /language:fr-FR /updates:FALSE /eula:FALSE'"


These Chocolatey Packages only contain installation routines. The software itself is downloaded from the official sources of the software developer. The maintainers of this package have no affiliation with the software developer.



This project is under the Apache License 2.0 License. See the LICENSE file for the full license text.

(c) 2020, Jordi Garcia

$packageName                = 'Office365Business'
$bitCheck                   = Get-ProcessorBits
$forceX86                   = $env:chocolateyForceX86
$arch                       = if ($BitCheck -eq 32 -Or $forceX86 ) {'32'} else {'64'}
$officetempfolder           = Join-Path $env:Temp 'Office365Business'
$configurationFile          = Join-Path $officetempfolder 'configuration.xml'
$defaultProductID           = 'O365BusinessRetail'
$defaultLanguageID          = 'MatchOS'
$defaultUpdates             = 'TRUE'
$defaultAcceptEULA          = 'TRUE'
$defaultExclude             = @()

$pp = Get-PackageParameters

if ($pp['configpath'])
    $configurationFile = $pp['configpath']
    Write-Output "Custom config specified: $configurationFile"
    Write-Output 'No custom configuration specified. Generating one...'

    if ($pp['productid']) {
        $paramProductID = $pp['productid']
        Write-Output "Custom Product ID specified: $paramProductID"
    else {
        Write-Output "No Product ID specified, using default: $defaultProductID"
        $paramProductID = $defaultProductID

    if ($pp['exclude']) {
        $paramExclude = $pp['exclude'].split(" ")
        Write-Output "The following apps will not be installed: $paramExclude"
    else {
        Write-Output "No excluded apps specified, installing all"
        $paramExclude = $defaultExclude

    if ($pp['language']) {
        $paramLanguageID = $pp['language']
        Write-Output "Custom Language ID specified: $paramLanguageID"
    else {
        Write-Output "No Language ID specified, using default: $defaultLanguageID"
        $paramLanguageID = $defaultLanguageID

    if ($pp['updates']) {
        $paramUpdate = $pp['updates']
        Write-Output "Custom updates value specified: $paramUpdate"
    else {
        Write-Output "No updates value specified, using default: $defaultUpdates"
        $paramUpdate = $defaultUpdates

    if ($pp['eula']) {
        $paramEula = $pp['eula']
        Write-Output "Custom eula value specified: $paramEula"
    else {
        Write-Output "No eula value specified, using default: $defaultAcceptEULA"
        $paramEula = $defaultAcceptEULA

    # Assign the CSV and XML Output File Paths
    $XML_Path = $configurationFile

    #create path
    if (-Not(Test-Path $officetempfolder)) {
        New-Item -ItemType Directory -Force -Path $officetempfolder

    # Create the XML File Tags
    $xmlWriter = New-Object System.XMl.XmlTextWriter($XML_Path, $Null)
    $xmlWriter.Formatting = 'Indented'
    $xmlWriter.Indentation = 1
    $XmlWriter.IndentChar = "`t"
    $xmlWriter.WriteComment('Office 365 client deployment configuration')

    # Create the Initial  Node
    $xmlDoc = [System.Xml.XmlDocument](Get-Content $XML_Path);
    $addNode = $xmlDoc.CreateElement("Add")
    $addNode.SetAttribute("OfficeClientEdition", "$arch")
    $addNode.SetAttribute("Channel", "Current")

    $productNode = $addNode.AppendChild($xmlDoc.CreateElement("Product"));
    $productNode.SetAttribute("ID", $paramProductID)

    $languageNode = $productNode.AppendChild($xmlDoc.CreateElement("Language"));
    $languageNode.SetAttribute("ID", $paramLanguageID)

    foreach ($ExcludeApp in $paramExclude) {
        $excludeNode = $productNode.AppendChild($xmlDoc.CreateElement("ExcludeApp"));
        $excludeNode.SetAttribute("ID", $ExcludeApp)

    $updatesNode = $xmlDoc.CreateElement("Updates")
    $updatesNode.SetAttribute("Enabled", $paramUpdate)

    $displayNode = $xmlDoc.CreateElement("Display")
    $displayNode.SetAttribute("Level", "None")
    $displayNode.SetAttribute("AcceptEULA", $paramEula)

    $loggingNode = $xmlDoc.CreateElement("Logging")
    $loggingNode.SetAttribute("Path", "%temp%")

    $removeMSINode = $xmlDoc.CreateElement("RemoveMSI")
    $removeMSINode.SetAttribute("All", "TRUE")


$packageArgs                = @{
    packageName             = 'Office365DeploymentTool'
    fileType                = 'exe'
    url                     = ''
    checksum                = '40bd32615a9dd98729adf2833d9f52468babe62b6a2fd0dbfc8c748adc8a24fa'
    checksumType            = 'sha256'
    softwareName            = 'Office365Business*'
    silentArgs              = "/extract:`"$officetempfolder`" /log:`"$officetempfolder\OfficeInstall.log`" /quiet /norestart"
    validExitCodes          = @(
        0, # success
        3010, # success, restart required
        2147781575, # pending restart required
        2147205120  # pending restart required for setup update

# Download and install the deployment tool
Install-ChocolateyPackage @packageArgs

# Use the deployment tool to download the setup files
$packageArgs['packageName'] = 'Office365BusinessInstaller'
$packageArgs['file'] = "$officetempfolder\Setup.exe"
$packageArgs['silentArgs'] = "/download $configurationFile"
Install-ChocolateyInstallPackage @packageArgs

# Run the actual Office setup
$packageArgs['file'] = "$officetempfolder\Setup.exe"
$packageArgs['packageName'] = $packageName
$packageArgs['silentArgs'] = "/configure $configurationFile"
Install-ChocolateyInstallPackage @packageArgs

if (Test-Path "$officetempfolder") {
    Remove-Item -Recurse "$officetempfolder"

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Add to Builder Version Downloads Last Updated Status
Office 365 Business 16731.20354 1053507 Tuesday, October 24, 2023 Approved
Office 365 Business 16731.20290 716792 Saturday, September 30, 2023 Approved
Office 365 Business 16626.20148 803979 Tuesday, August 1, 2023 Approved
Office 365 Business 16529.20182 395403 Sunday, July 16, 2023 Approved
Office 365 Business 16501.20196 521076 Tuesday, June 13, 2023 Approved
Office 365 Business 16327.20214 672559 Wednesday, May 10, 2023 Approved
Office 365 Business 16227.20258 461153 Wednesday, April 12, 2023 Approved
Office 365 Business 16130.20218 415437 Wednesday, March 15, 2023 Approved
Office 365 Business 16026.20170 408963 Wednesday, February 15, 2023 Approved
Office 365 Business 15928.20216 301965 Wednesday, January 11, 2023 Approved
Office 365 Business 15726.20202 591031 Wednesday, December 7, 2022 Approved
Office 365 Business 15330.20230 1773462 Friday, July 22, 2022 Approved
Office 365 Business 15028.20160 1563675 Wednesday, April 13, 2022 Approved
Office 365 Business 14729.20228 1242425 Monday, February 7, 2022 Approved
Office 365 Business 14326.20404 1564984 Thursday, October 21, 2021 Approved
Office 365 Business 14131.20278 1176939 Friday, July 23, 2021 Approved
Office 365 Business 13901.20336 842342 Saturday, April 17, 2021 Approved
Office 365 Business 13530.20376 586984 Thursday, January 28, 2021 Approved
Office 365 Business 13426.203084.0.20201214 201122 Monday, January 4, 2021 Approved
Office 365 Business 13328.20292 398991 Sunday, November 1, 2020 Approved
Office 365 Business 12827.20268 606297 Wednesday, June 24, 2020 Approved
Office 365 Business 12130.20272.12312019 502186 Tuesday, December 31, 2019 Approved
Office 365 Business 12130.20272 18482 Saturday, December 21, 2019 Approved
Office 365 Business 11901.20022 114840 Thursday, October 17, 2019 Approved
Office 365 Business 11509.33604 216640 Tuesday, March 26, 2019 Approved
Office 365 Business 11107.33602 65805 Tuesday, November 20, 2018 Approved
Office 365 Business 11023.33600.2 3823 Thursday, November 1, 2018 Approved
Office 365 Business 11023.33600 223 Thursday, November 1, 2018 Approved
Office 365 Business 10810.33603 10264 Monday, September 10, 2018 Approved
Office365Business 16.0.9119.3601 23745 Monday, April 16, 2018 Approved
Office365Business 16.0.8008.3601 26691 Sunday, May 21, 2017 Approved
Office365Business 16.0.7614.3602 7809 Tuesday, December 6, 2016 Approved
Office365Business 16.0.7213.5776 974 Wednesday, October 26, 2016 Approved
Office365Business 16.0.6366.2075 2851 Thursday, February 11, 2016 Approved

enable optional installation parameters

This package has no dependencies.

Discussion for the Office 365 Business Package

Ground Rules:

  • This discussion is only about Office 365 Business and the Office 365 Business package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Office 365 Business, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus