Skip to main content

vserver cifs users-and-groups update-names

Update the names of Active Directory users and groups

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

Description​

The vserver cifs users-and-groups update-names command updates the names of Active Directory users and groups that are registered in local databases on the cluster and reports the status of the update operations. This is done so that objects that were renamed in the Active Directory can be properly displayed and configured in the local databases.

Parameters​

-vserver <vserver name> - Vserver
If you specify this parameter, the command will only be performed within the scope of the Vserver that matches the specified Vserver name.
{ [-display-failed-only {true|false}] - Display Only Failures
If you set this parameter to true, the command displays only the Active Directory users and groups that failed to update. If set to false, the command displays only the Active Directory users and groups that successfully updated.
| [-suppress-all-output {true|false}]} - Suppress All Output
If you set this parameter to true, the command does not display information about the status of the updates of Active Directory users and groups. To display information about the status of the updates, set this parameter to false or do not specify this parameter in the command.

Examples​

The following example updates the names of Active Directory users and groups associated with Vserver "vs1". In the last case, there is a dependent chain of names that needs to be updated. 

cluster1::*> vserver cifs users-and-groups update-names -vserver vs1

   Vserver:           vs1
   SID:               S-1-5-21-123456789-234565432-987654321-12345
   Domain:            EXAMPLE1
   Out-of-date Name:  dom_user1
   Updated Name:      dom_user2
   Status:            Successfully updated

   Vserver:           vs1
   SID:               S-1-5-21-123456789-234565432-987654322-23456
   Domain:            EXAMPLE2
   Out-of-date Name:  dom_user1
   Updated Name:      dom_user2
   Status:            Successfully updated

   Vserver:           vs1
   SID:               S-1-5-21-123456789-234565432-987654321-123456
   Domain:            EXAMPLE1
   Out-of-date Name:  dom_user3
   Updated Name:      dom_user4
   Status:            Successfully updated; also updated SID "S-1-5-21-123456789-234565432-987654321-123457"
                      to name "dom_user5"; also updated SID "S-1-5-21-123456789-234565432-987654321-123458" 
                      to name "dom_user6"; also updated SID "S-1-5-21-123456789-234565432-987654321-123459" 
                      to name "dom_user7"; also updated SID "S-1-5-21-123456789-234565432-987654321-123460" 
                      to name "dom_user8"

The command completed successfully. 7 Active Directory objects have been updated.