Add method of the PS_DhcpServerv4Scope class
Adds an IPv4 scope on the server.
Syntax
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
);
Parameters
-
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: 255.255.255.0.
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.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2012 |
| Namespace |
Root\Microsoft\Windows\DHCP |
| MOF |
|
| DLL |
|