windows_dhcp Cookbook

This cookbook installs the DHCP on Windows Server including all necessary roles and features.

Requirements

Platform

• Windows Server 2008 R2 Family
• Windows Server 2012 Family

Cookbooks

• none

Usage

windows_dhcp::default

e.g. Just include windows_dhcp in your node's run_list:

{
  "name":"my_node",
  "run_list": [
    "recipe[windows_dhcp]"
  ]
}

Resources

windows_dhcp_lease

Actions

• :create: Creates a lease entry
• :delete: Deletes a lease entry

Properties

• name: name attribute. Name of the lease entry.
• comptername: Name of the DHCP server.
• description: Description field entry.
• ipaddress: IPv4 or IPv6 address or the lease entry. Required Regex: IPv4 or IPv6
• leaseexpirytime: Time to expire the lease. Regex for YYYY-MM-DD HH:MM:SS
• macaddress: MAC Address for the lease entry. Note: Any use of '-' or ':' will be removed.
• scopeid: IPv4 or IPv6 scope ex. 192.168.1.1 Required Regex: IPv4 or IPv6
• version: Version of IP address. Default 4 Available Options (4, 6)

Examples

  # Create lease entry of workstation at 192.168.1.10
  windows_dhcp_lease 'workstation' do
    action :create
    ipaddress '192.168.1.10'
    scopeid '192.168.1.1'
  end

windows_dhcp_reservation

Actions

• :create: Creates a reservation entry
• :delete: Deletes a reservation entry
• :update: Updates a reservation entry

Properties

• name: name attribute. Name of the reservation entry.
• comptername: Name of the DHCP server.
• description: Description field entry.
• ipaddress: IPv4 or IPv6 address or the reservation entry. Required Regex: IPv4 or IPv6
• macaddress: MAC Address for the reservation entry. Note: Any use of '-' or ':' will be removed. Required
• scopeid: IPv4 or IPv6 scope ex. 192.168.1.1 Required Regex: IPv4 or IPv6
• version: Version of IP address. Default 4 Available Options (4, 6)

Examples

  # create reservation entry of 'workstation' at 192.168.1.10 with mac address of '00-00-00-00-00-00'
  windows_dhcp_reservation 'workstation' do
    action :create
    ipaddress '192.168.1.10'
    scopeid '192.168.1.1'
    macaddress '00-00-00-00-00-00'
  end

  # delete reservation entry of 'workstation' at 192.168.1.10
  windows_dhcp_reservation 'workstation' do
    action :delete
    scopeid '192.168.1.1'
  end

  # update reservation entry of 'workstation' at 192.168.1.10 with mac address of '00-00-00-00-00-10'
  windows_dhcp_reservation 'workstation' do
    action :update
    ipaddress '192.168.1.10'
    macaddress '00-00-00-00-00-10'
    scopeid '192.168.1.1'
  end

windows_dhcp_scope

Actions

• :create: Creates a reservation entry
• :delete: Deletes a reservation entry
• :update: Updates a reservation entry

Properties

• name: name attribute. Name of the scope entry.
• computername: Name of the DHCP server.
• description: Description field entry.
• endrange: Ending IP of the scope. Regex: IPv4 or IPv6
• scopeid: IPv4 or IPv6 scope ex. 192.168.1.1 Required Regex: IPv4 or IPv6
• startrange: Staring IP of the scope. Regex: IPv4 or IPv6
• subnetmask: Subnet mask address of the scope. Regex: IPv4 or IPv6
• version: Version of IP address. Default 4 Available Options (4, 6)

Examples

  # Create scope 'Internal' of '192.168.1.1' with starting ip of '192.168.1.10' and ending IP of '192.168.1.250'
  windows_dhcp_scope 'Internal' do
    action :create
    startrange '192.168.1.10'
    endrange '192.168.1.250'
    subnetmask '255.255.255.0'
    scopeid '192.168.1.1'
  end

Contributing

1. Fork the repository on Github
2. Write your change
3. Write tests for your change (if applicable)
4. Run the tests, ensuring they all pass
5. Submit a Pull Request using GitHub

License and Authors

Authors:: Derek Groh (dgroh@arch.tamu.edu)