chauthpol

Edit online

The chauthpol command changes the general attributes of an authentication policy, such as the policy name and the activation state.

General attributes are attributes that apply to every policy type. To change specific attributes that apply only to some policy types, use the setauthpol command.
Read syntax diagramSkip visual syntax diagram chauthpol  -name  new_pol_name  -activate  -username  user_name  -pw  password  -quiet  pol_name  "-"

Parameters

-name new_pol_name
(Optional) The new name for the authentication policy. This parameter cannot be used with the -activate parameter.
-activate
(Optional) Activates the specified authentication policy. This parameter requires the -username and -pw parameters, and optionally the -quiet parameter. This parameter cannot be used with the -name parameter. To use this parameter, you must be logged in with the currently active authentication policy with storage administrator authority. The name that is specified by the -username parameter must have storage administrator authority in the specified authentication policy to be activated.
-username user_name
(Optional) A valid user name in the policy that is being activated.
Note: You must have administrator privileges in the current policy to modify the user name in the new policy.
This parameter is required when the -activate parameter is specified.
-pw password
(Optional) The password of the user name that is specified in the -username parameter.
Note: You must have administrator privileges in the current policy to modify the password in the new policy.
This parameter is required when the -activate parameter is specified.
-quiet
(Optional) Turns off the modification confirmation prompt for this command.
pol_name | –
(Required) The name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example 1: Changing the attributes of an authentication policy.

dscli> chauthpol –quiet –name my_policy1 my_policy_01
Output:
Authentication policy my_policy_01 successfully modified.

Example 2: Changing the attributes of an authentication policy.

dscli> chauthpol –quiet 
–activate –username admin –pw test2 my_policy2
Output:
Authentication policy my_policy_2 successfully modified.