Skip to main content

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

Contributors
Suggest changes

Load one or more local UNIX groups 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-group load-from-uri command loads UNIX groups from a universal resource identifier (URI). The URI must contain group information in the UNIX /etc/group format:

group_name :password :group_ID :comma_separated_list_of_users

The command discards the value of the password field.

Parameters

-vserver <vserver> - Vserver

Use this parameter to specify the Vserver on which to locate the local UNIX groups.

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

Use this parameter to specify the URI from which the command loads group information. The URI scheme must be either ftp(s) or http(s)

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

Use this parameter with the value true to specify that group information loaded from the URI should overwrite existing group information. The default value is false , specifying that group information loaded from the URI should not overwrite existing group information.

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

By default, Data 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 Groups 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 group information from the URI ftp://ftp.example.com/groups onto a Vserver named vs0:

cluster1::> vserver services name-service unix-group load-from-uri -vserver vs0 -uri ftp://ftp.example.com/groups