MS Office module for Puppet

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with msoffice
   • What msoffice affects
   • Beginning with msoffice
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

Overview

Puppet module to manage Microsoft Office on Windows (2003-2016)

Module Description

The purpose of this module is to install the Microsoft Office suite and configure it's many service packs, tools, utilities and registry options.

Setup

What msoffice affects

• Installs packages for each office product
• Installs package for the Service Pack (if configured)
• Installs packages for each language pack (if configured)

Beginning with msoffice

To install Word and Excel packages from Office 2010 SP1:

    msoffice { 'office 2010':
      version     => '2010',
      edition     => 'Professional Pro',
      sp          => '1',
      license_key => 'XXX-XXX-XXX-XXX-XXX',
      products    => ['Word,'Excel'],
      ensure      => present
    }

Usage

Classes and Defined Types

Defined Type: msoffice

The primary definition of the msoffice module. It will install office products, language packs and updates.

Parameters within msoffice:

version

The version of office to install

edition

The edition of office to install

sp

The service pack update to apply

license_key

The license key required to install

arch

The architecture version of office

products

The list of products to install as part of the office suite

lang_code

The language code of the default install language

ensure

Ensure the existence of the office installation

deployment_root

The network location where the office installation media is stored

Defined Type: msoffice::package

The definition which installs the main office products.

Parameters within msoffice::package:

version

The version of office to install

edition

The edition of office to install

license_key

The license key required to install

arch

The architecture version of office

lang_code

The language code of the default install language

products

The list of products to install as part of the office suite

sp

The service pack update to apply

ensure

Ensure the existence of the office installation

deployment_root

The network location where the office installation media is stored

Defined Type: msoffice::lip

The definition which installs language interface packs into an existing office installation

Parameters within msoffice::lip:

version

The version of office that was installed

lang_code

The language code of the language to install

arch

The architecture version of office

deployment_root

The network location where the office installation media is stored

Defined Type: msoffice::servicepack

The definition which installs service packs into an existing office installation

Parameters within msoffice::servicepack:

version

The version of office

sp

The service pack update to install

arch

The architecture version of office

deployment_root

The network location where the office installation media is stored

Reference

Defined Types

Public Defined Types

• msoffice: The core office suite installation
• msoffice::package: The core office suite installation
• msoffice::servicepack: The service pack update for office
• msoffice::lip: The language interface pack for office

Limitations

This module is tested on the following platforms:

• Windows 2008 R2

It is tested with the OSS version of Puppet only.

Support for only RTM versions Support for only Retail/Volume editions

Development

Contributing

Please read CONTRIBUTING.md for full details on contributing to this project.

Changelog

All notable changes to this project will be documented in this file. Each new release typically also includes the latest modulesync defaults. These should not affect the functionality of the module.

v3.1.2 (2018-10-19)

Full Changelog

Merged pull requests:

• modulesync 2.2.0 and allow puppet 6.x #74 (bastelfreak)

v3.1.1 (2018-09-06)

Full Changelog

Merged pull requests:

• allow puppetlabs/stdlib 5.x #71 (bastelfreak)
• Remove docker nodesets #67 (bastelfreak)
• drop EOL OSs; fix puppet version range #66 (bastelfreak)
• typo in example README #62 (cedricve)

v3.1.0 (2017-11-17)

Full Changelog

Implemented enhancements:

• Add support for Office 2016 #49 (mkszuba)

Merged pull requests:

• bump puppet version dependency to >= 4.7.1 \< 6.0.0 #60 (bastelfreak)

v3.0.0 (2017-11-15)

Full Changelog

Fixed bugs:

• fails on pre-SP2 WinXP because it doesn't have powershell installed. #14

Merged pull requests:

• release 3.0.0 #57 (bastelfreak)
• Update package.pp #55 (bradh)

v2.2.0 (2017-01-13)

This is the last release with Puppet 3 support!

• Set min version_requirement for Puppet + deps
• Modulesync with latest Vox Pupuli defaults

2016-10-27 - Release 2.1.0

• GH-33 Support puppetlabs/powershell 2.x

2016-05-29 - Release 2.0.0

• drop ruby 1.8.0
• rubocop clean
• modulesync integrated
• moved to Voxpupuli

0.0.2 Added lots of testing and support for installing LIPs.

0.0.1 The initial proof-of-concept version

* This Changelog was automatically generated by github_changelog_generator