Add method of the PS_DhcpServerv4Scope class

Adds an IPv4 scope on the server.


uint32 Add(
  [in]  string            ComputerName,
  [in]  string            StartRange,
  [in]  string            EndRange,
  [in]  string            Name,
  [in]  string            Description,
  [in]  string            State,
  [in]  string            SuperscopeName,
  [in]  uint32            MaxBootpClients,
  [in]  boolean           ActivatePolicies,
  [in]  boolean           PassThru,
  [in]  boolean           NapEnable,
  [in]  string            NapProfile,
  [in]  uint16            Delay,
  [in]  datetime          LeaseDuration,
  [in]  string            SubnetMask,
  [in]  string            Type,
  [out] DhcpServerv4Scope cmdletOutput


ComputerName [in]

DNS name or IP address of the target computer running the DHCP server service.

StartRange [in]

Start IP address of the range within the subnet from which IP addresses should be leased by the server.

EndRange [in]

End IP address of the range within the subnet from which IP addresses should be leased by the server.

Name [in]

Name of the IPv4 scope being added.

Description [in]

Description string for the IPv4 scope being added.

State [in]

This specified if the scope should be created in active or inactive state. Valid values are {Active, Inactive}. Only an active scope will respond to client requests. Default value is Active

Active ("Active")

InActive ("InActive")

SuperscopeName [in]

The name of the superscope to which the scope will be added.

MaxBootpClients [in]

If the scope type is specified as Both to allow for both DHCP and BOOTP clients, this parameter allows to specify the maximum number of bootp clients which should be leased an IP address from this scope.

ActivatePolicies [in]

This specifies if the policy enforcement is to be enabled/disabled on the scope being added. Default value is true (enabled).

PassThru [in]

If this parameter is specified, the cmdlet returns the PowerShell object which is modified.

NapEnable [in]

This parameter specifies whether NAP should be enabled for this scope or not. If NAP is enabled, DHCP server passes on the SoH (statement of health) received from the client to the NPS server. Based on the NAP profile set, NPS server determines the network access to be granted to the client.

NapProfile [in]

The NAP profile should be set only if NAP is enabled on the scope. The NAP profile refers to the MS Service Class which is a condition used in network policies on NPS.

Delay [in]

Specifies the number of milliseconds by which the server should wait before responding to the client requests. This should be configured if the scope is part of a split scope deployment and this server should act as a secondary server for the scope being added.

LeaseDuration [in]

The time interval for which an IP address should be leased to a client in this scope. This should be specified in the format day.hrs:mins:secs

SubnetMask [in]

The subnet mask for the scope specified in IP address format. For example:

Type [in]

The type of clients to be serviced by the scope. Valid values are DHCP, BOOTP, BOTH.

Dhcp ("Dhcp")

Bootp ("Bootp")

Both ("Both")

cmdletOutput [out]

An embedded instance of the DhcpServerv4Scope class.


Minimum supported client

None supported

Minimum supported server

Windows Server 2012







See also