Skip to content

Latest commit

 

History

History
153 lines (123 loc) · 2.88 KB

DhcpScopes.adoc

File metadata and controls

153 lines (123 loc) · 2.88 KB

DSC Resource 'DhcpScopes'

DhcpScopes is used to manage IP address scopes.

An IP-address scope is a consecutive range of possible IP addresses that the DHCP server can lease to clients on a subnet.

Source

DSC Resource

Documentation

Table 1. Attributes of category 'DhcpScopes'
Parameter Attribute DataType Description Allowed Values

Scopes

Hashtable[]

Set of IP address scopes.

DomainCredential

PSCredential

Credentials to authorizes a DHCP in Active Directory.

This resource must run on an Active Directory domain controller.

Table 2. Attributes of category 'DhcpScopes/Scopes'
Parameter Attribute DataType Description Allowed Values

ScopeId

Key

String

Scope Identifier of the DHCP scope

Name

String

Name of this DHCP Scope

SubnetMask

String

Subnet mask for the scope specified in IP address format

IPStartRange

String

Starting address to set for this scope

IPEndRange

String

Ending address to set for this scope

Description

String

Description of DHCP Scope

LeaseDuration

String

Time interval for which an IP address should be leased.

This should be specified in the following format: Days.Hours:Minutes:Seconds
For example, '02.00:00:00' is 2 days and '08:00:00' is 8 hours.

State

String

Whether scope should be active or inactive

  • Active

  • Inactive

AddressFamily

String

Address family type

  • IPv4

Ensure

String

Whether DHCP scope should be present or removed

  • Present

  • Removed

Example
DhcpScopes:
  Scopes:
    - ScopeId: 192.169.1.0
      IPStartRange: 192.169.1.1
      IPEndRange: 192.169.1.254
      Name: Client1
      SubnetMask: 255.255.255.0
      LeaseDuration: 08:00:00
      State: Active
      AddressFamily: IPv4
    - ScopeId: 192.169.2.0
      IPStartRange: 192.169.2.1
      IPEndRange: 192.169.2.254
      Name: Client2
      SubnetMask: 255.255.255.0
      LeaseDuration: 08:00:00
      State: Active
      AddressFamily: IPv4
  DomainCredential: '[ENC=PE9ianMgVmVy...=]'