/microsoft-recipes

OLD - DO NOT USE! Use arubdesu/office-recipes instead

Primary LanguagePythonApache License 2.0Apache-2.0

microsoft-recipes

Unofficial (meaning not maintained by Microsoft) Office (and Microsoft-related) Recipes for AutoPkg

This repo contains update recipes for Lync (soon to be rebranded Communicator Messenger SkypeForBusiness), AutoUpdate 3.x (AKA MAU), and the Office 2016 suite. (OneNote can be obtained from the Mac App Store, so it is only partially included.)

What the who?

These used to be located in the autopkg/recipes and autopkg/arubdesu-recipes repos, but they grew in number and variety to the point that it made sense to gather them all in one place.

These are more than just traditional 'update' recipes - while the original intention of autopkg was to grab updates by using mechanisms that are as-close-as-possible to the native polling an apps auto-update functionality would use, Office 2016 has many deployment permutations to consider. All of the products referenced above have 'combo' update flavored packages, which install the entire product. MAU and Lync are less of a concern, as they do not require licensing... but the story becomes interesting with Office 2016:

  • While Office 2016 can be deployed in many ways, it comes in several different flavored installers:
    • Standalone, meaning each individual product install has a bundled version of MAU
    • Volume Licensed (VL), per-product or full suite installers
    • 'Combo' updates, similar to how Lync updates are full, potentially-installable versions
    • 'Delta' updates, which are slated for release with 15.19
  • And finally, there is the new concept of a 'SKU-less' installer, meaning a version of the suite that can be installed (except in an AutoDMG workflow) and licensed for O365 or volume licensing after the fact.

Besides the VL suite installer and the SKU-less version, the Standalone flavor can also be licensed because it contains the proper support files.

Breakdown Graphic

All the things!

Like Pokemon, we've gotta catch them all. Contained in this repo is a custom AutoPkg processor that allows you to fetch standalone, combo, or delta flavors of the Office 2016 apps, and recipes that can be customized via overrides to grab the one(s) you want. This functionality was enabled by @ftiff by adapting code worked on by @tvsutton, @arubdesu, and originally authored by @gregneagle.

A separate set of recipes operate on the SKU-less suite. The included JSS-README describes a workflow for deploying the 2016 apps (which require you to override the MSVERSION key to be 'Standalone') along with policy templates that even enable it to be licensed if you supply the 15.17+ bundled 'VL Serializer' package.

...But, can we really have it all?

If by that you mean you'd like to fetch multiple flavored (delta/combo/standalone) packages from the same AutoPkg setup, yes we can.

Standalone/SKU-Less Installer(s) + Munki Note

For those who have left MAU out of their deployment and want to continue doing so, you'll want to add ChoiceChangesXML to your override's pkginfo stanza, like so:

<key>installer_choices_xml</key>
<array>
    <dict>
        <key>attributeSetting</key>
        <integer>0</integer>
        <key>choiceAttribute</key>
        <string>selected</string>
        <key>choiceIdentifier</key>
        <string>com.microsoft.autoupdate</string>
    </dict>
</array>