Windows Dev Center

AddByLoadBalance method of the PS_DhcpServerv4Failover class

Adds a new IPv4 failover relationship on the server.

Syntax


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] string   cmdletOutput
);

Parameters

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.

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_DhcpServerv4Failover

 

 

Show:
© 2015 Microsoft