AddByLoadBalance method of the PS_DhcpServerv4Failover class

Adds a new IPv4 failover relationship on the server.


uint32 AddByLoadBalance(
  [in]  string               ComputerName,
  [in]  string               Name,
  [in]  string               PartnerServer,
  [in]  string               ScopeId[],
  [in]  datetime             MaxClientLeadTime,
  [in]  boolean              AutoStateTransition,
  [in]  datetime             StateSwitchInterval,
  [in]  boolean              Force,
  [in]  string               SharedSecret,
  [in]  boolean              PassThru,
  [in]  uint32               LoadBalancePercent,
  [out] DhcpServerv4Failover cmdletOutput


ComputerName [in]

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

Name [in]

Name of the failover relationship to be created

PartnerServer [in]

IP address or hostname of the partner server

ScopeId [in]

Scope identifiers (in IPv4 address format) which are to be added to the failover relationship.

MaxClientLeadTime [in]

Maximum Client Lead time for the failover relationship. Default is 1 hour.

AutoStateTransition [in]

Enable/Disable automatic state transition from COMMUNICATION INTERRUPTED state to PARTNER DOWN state based on expiry of the timer (Safe Period) while in COMMUNICATION INTERRUPTED state. Valid values are True, False. Default value is False. However, this will be set to True if safe period is specified.

StateSwitchInterval [in]

Time interval for which the server should continue to operate in COMMUNICATION INTERRUPTED state before transitioning to PARTNER DOWN state

Force [in]

If shared secret is specified, user confirmation is sought since shared secret specified may be transferred in clear text transport in case of remote management.

SharedSecret [in]

Shared secret to be used for message digest authentication. If not specified, message digest authentication is turned off.

PassThru [in]

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

LoadBalancePercent [in]

Percentage of DHCP client requests which should be served by the local server. The remaining requests would be served by the partner server. Default is 50%.

cmdletOutput [out]

An embedded instance of a DhcpServerv4Failover object.


Minimum supported client

None supported

Minimum supported server

Windows Server 2012







See also