Share via


SetByWithRange method of the PS_DhcpServerv4Scope class

Sets the properties of an existing IPv4 Scope on the server.

Syntax

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

Parameters

ActivatePolicies [in]

This specifies if the policy enforcement is to be enabled/disabled on the scope. Valid values are True, False.

PassThru [in]

If true, passes the object created by this cmdlet through the pipeline. By default, this cmdlet does not pass any objects through the pipeline.

ScopeId [in]

Scope identifier (in IPv4 address format) whose properties are being set

Name [in]

Name to be set for the scope

State [in]

State of the scope. Valid values are Active and InActive.

Active ("Active")

InActive ("InActive")

LeaseDuration [in]

Duration of the IPv4 address lease to be given for the clients of this scope

Delay [in]

Time in milliseconds by which the server should delay sending a response to clients. This setting should be used on the secondary server in a split scope configuration.

NapEnable [in]

Enable/Disable NAP for the scope. Valid values are True, False.

SuperscopeName [in]

Name of the superscope to which this scope is to be added.

MaxBootpClients [in]

If the scope supports both types of clients (Bootp, Dhcp), maximum number of bootp clients to be permitted to get an IP address lease from the scope.

NapProfile [in]

If NAP is enabled for the scope, the name of the NAP profile to be used for clients in the scope. The NAP profile refers to the MS Service Class which is a condition used in network policies on NPS.

StartRange [in]

Start address of the IPv4 range to be set for the scope. If a new IP range is being set, the previously set IP range of the scope is discarded.

EndRange [in]

End address of the IPv4 range to be set for the scope. If a new IP range is being set, the previously set IP range of the scope is discarded.

Description [in]

Description to be set for the scope

Type [in]

Type of the scope. Valid values are DHCP, BOOTP and BOTH. The type of the scope determines if the server will respond to only DHCP client requests, only BOOTP client requests or Both types of clients.

Dhcp ("Dhcp")

Bootp ("Bootp")

Both ("Both")

ComputerName [in]

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

cmdletOutput [out]

An embedded instance of the DhcpServerv4Scope class.

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012
Namespace
Root\Microsoft\Windows\DHCP
MOF
DhcpServerPsProvider.mof
DLL
DhcpServerPsProvider.dll

See also

PS_DhcpServerv4Scope