Forge Home

msuac

manage User Account Control on Microsoft Windows

26,824 downloads

26,462 latest version

3.7 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.0.3 (latest)
  • 0.0.2
  • 0.0.1
released Aug 15th 2013

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'jonnyx-msuac', '0.0.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add jonnyx-msuac
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install jonnyx-msuac --version 0.0.3

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

jonnyx/msuac — version 0.0.3 Aug 15th 2013

#msuac

####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 msuac
  4. Usage - Configuration options and additional functionality
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module

##Overview

The msuac module allows you to manage Microsoft User account control (MSUAC). UAC is a feature in Windows to help protect you from intrusive software by warning you if changes are being made. When a change to the computer is being made that requires administrative privileges, UAC will prompt you based on its configuration. This module will allow you to change those settings.

##Module Description

This module will change the registry key values based on the desired UAC configuration.

##Setup

###What msuac affects

  • If UAC is set to 'Disabled', a reboot will be required for changes to take effect.

###Setup Requirements

Depends on the following modules:

puppetlabs/registry

puppetlabs/stdlib

##Usage

Class: msuac

    class { 'msuac':
      enabled => false,
      prompt  => disabled,
    }

##Parameters:

$prompt_value is one of the three option:

0x00000000 (disabled)

This option SHOULD be used to allow the Consent Admin to perform an operation that requires elevation without consent or credentials.

0x00000001 (authprompt)

This option SHOULD be used to prompt the Consent Admin to enter his or her user name and password (or another valid admin) when an operation requires elevation of privilege.

0x00000002 (default, consentprompt)

This option SHOULD be used to prompt the administrator in Admin Approval Mode to select either "Permit" or "Deny" an operation that requires elevation of privilege. If the Consent Admin selects Permit, the operation will continue with their highest available privilege. "Prompt for consent" removes the inconvenience of requiring that users enter their name and password to perform a privileged task.

##Limitations

Windows Versions supported:

    - Windows Visa
    - Windows 7
    - Server 2008

##Development

##Release Notes/Contributors/Etc

Contributors:

    Thomas Linkin <tom@puppetlabs.com>