Defined Type: registry::value

Defined in:
manifests/value.pp

Overview

Define: registry::value

This defined resource type provides a higher level of abstraction on top of the registry_key and registry_value resources. Using this defined resource type, you do not need to explicitly manage the parent key for a particular value. Puppet will automatically manage the parent key for you.

Parameters:

key

The path of key the value will placed inside.

value

The name of the registry value to manage. This will be copied from the resource title if not specified. The special value of ‘(default)’ may be used to manage the default value of the key.

type

The type the registry value. Defaults to ‘string’. See the output of ‘puppet describe registry_value` for a list of supported types in the “type” parameter.

data

The data to place inside the registry value.

Actions:

- Manage the parent key if not already managed.
- Manage the value

Requires:

- Registry Module
- Stdlib Module

Sample Usage:

This example will automatically manage the key. It will also create a value named ‘puppetmaster’ inside this key.

class myapp {
  registry::value { 'puppetmaster':
    key => 'HKLM\Software\Vendor\PuppetLabs',
    data => 'puppet.puppetlabs.com',
  }
}

Parameters:

  • key (Any)
  • value (Any) (defaults to: undef)
  • type (Any) (defaults to: 'string')
  • data (Any) (defaults to: undef) 


42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
 
# File 'manifests/value.pp', line 42

define registry::value($key, $value=undef, $type='string', $data=undef) {
  # validate our inputs.
  validate_re($key, '^\w+', "key parameter must not be empty but it is key => '$key'")
  validate_re($type, '^\w+', "type parameter must not be empty but it is type => '$type'")

  $value_real = $value ? {
    undef       => $name,
    '(default)' => '',
    default     => $value,
  }

  # Resource defaults.
  Registry_key { ensure => present }
  Registry_value { ensure => present }

  if !defined(Registry_key["${key}"]) {
    registry_key { "${key}": }
  }

  # If value_real is an empty string then the default value of the key will be
  # managed.
  registry_value { "${key}\\${value_real}":
    type => $type,
    data => $data,
  }
}