Skip to main content

vserver services name-service unix-user load-from-uri

Contributors
Suggest changes
PDFs

Load one or more local UNIX users from a URI

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver services name-service unix-user load-from-uri command loads one or more UNIX users from a universal resource identifier (URI). The URI must contain user information in the UNIX /etc/passwd format: user_name :password :user_ID :group_ID :full_name :home_directory :shell . The command discards the value of the password field and of the fields after the full_name field ( home_directory and shell ).

Parameters

-vserver <vserver> - Vserver

This specifies the Vserver on which the local UNIX user or users are to be located.

-uri {scheme://(hostname|IPv4 Address|'['IPv6 Address']')…​} - URI to Load From

This specifies the URI from which user information is to be loaded. The URI scheme must be either ftp(s) or http(s).

[-overwrite {true|false}] - Overwrite Entries

This optionally specifies whether user information from the URI overwrites existing user information. The default setting is false .

[-skip-name-validation {true|false}] - Skip Name Validation

By default, ONTAP validates the name to ensure it complies with the following rules:

  • The name contains only valid characters: 0 through 9, A through Z, a through z, "_", ".", and "-"

  • The name does not start with "-"

  • The name does not contain "$" except as the last character

If the parameter is set to true , the name validation is skipped.

[-foreground {true|false}] - Load Unix Users file in the Foreground

If this parameter is set to false , the operation runs as a job in the background. Otherwise, the command does not return until the operation is complete. The default value is true .

Examples

The following example loads user information from the URI ftp://ftp.example.com/users onto a Vserver named vs0:

node::> vserver services name-service unix-user load-from-uri -vserver vs0 -uri ftp://ftp.example.com/users