user virtual-ip

Function

The user virtual-ip command sets a user virtual IP address in the network extension function.

The undo user virtual-ip command deletes a user virtual IP address in the network extension function.

Format

user user-name virtual-ip ip-address

undo user user-name virtual-ip

Parameters

Parameter	Description	Value
user-name	Specifies the user name.	If the login name does not contain any space, the value is a string of 1 to 128 case-insensitive characters. If the login name contains spaces, the value is a string of 1 to 130 case-insensitive characters, and you must enclose the name with double quotation marks ("), for example, "user for test". The name cannot start or end with any spaces. When a user in a non-default authentication domain is specified, the user name must carry "@authentication-domain-name." For example, user1@test indicates user1 in the test authentication domain.
ip-address	Specifies the virtual IP address in the network extension function.	The value is in dotted decimal notation.

Parameter

Description

Value

user-name

Specifies the user name.

If the login name does not contain any space, the value is a string of 1 to 128 case-insensitive characters. If the login name contains spaces, the value is a string of 1 to 130 case-insensitive characters, and you must enclose the name with double quotation marks ("), for example, "user for test". The name cannot start or end with any spaces.

When a user in a non-default authentication domain is specified, the user name must carry "@authentication-domain-name." For example, user1@test indicates user1 in the test authentication domain.

ip-address

Specifies the virtual IP address in the network extension function.

The value is in dotted decimal notation.

Views

VPN database view

Default Level

2: Configuration level

Usage Guidelines

The virtual IP address can be configured only if network extension is enabled. If a virtual IP address pool is bound to the VPNDB user, the virtual IP address must belong to the address pool; otherwise, the virtual IP address should belong to the network extension IP address pool of the virtual gateway.

For the same virtual gateway, each user must have a unique virtual IP address.

To assign a virtual IP address that is being used by an online user to another user, the administrator should first force the user offline and then specify the IP address to the target user.

Example

# Set a virtual IP address in the network extension function of user abc to 10.1.1.2.

<sysname> system-view
[sysname] v-gateway gateway
[sysname-gateway] vpndb
[sysname-gateway-vpndb] user abc virtual-ip 10.1.1.2

# Delete the virtual IP address in the network extension function of user abc.

<sysname> system-view
[sysname] v-gateway gateway
[sysname-gateway] vpndb
[sysname-gateway-vpndb] undo user abc virtual-ip