puppet module to manage Microsoft Office on Windows (2003-2013)
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
manifests
spec
templates
.fixtures.yml
.gitignore
.msync.yml
.overcommit.yml
.pmtignore
.rspec
.rspec_parallel
.rubocop.yml
.sync.yml
.travis.yml
.yardopts
CHANGELOG.md
CONTRIBUTING.md
Gemfile
HISTORY.md
LICENSE
README.md
Rakefile
metadata.json

README.md

MS Office module for Puppet

Build Status Code Coverage Puppet Forge Puppet Forge - downloads Puppet Forge - endorsement Puppet Forge - scores

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
  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

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.