modify_named_credential
Updates an existing named credential. You can provide input parameters using command line arguments or an input properties file. It also supports the input_file tag for passwords and parameter values.
Format
emcli modify_named_credential -cred_name=<name> -new_cred_name<name> -cred_type=<credential_type> -cred_scope=<credential_scope> -cred_desc=<credential_description> -target_name=<target_name> -target_type=<target_type> -test -test_target_name=<test_target_name> -test_target_type=<test_target_type> -input_file=<tag|value> -properties_file=<filename> -attributes=<p1:v1;p2:v2;...> -remove_old_attributes
Options
-
cred_name
Credential name, such as MyBackUpCreds. This is required if you do not use the properties_file option.
-
new_cred_name
New credential name.
-
cred_type
Credential type.
-
cred_scope
Possible values are global instance. The default is global.
-
cred_desc
Credential description.
-
target_name
This is required when cred_scope is instance.
-
target_type
This is required when cred_scope is instance.
-
test
Use this option to test the credential before saving.
-
test_target_name
Use this option to supply the target name to test a global credential. This is mandatory when the scope is global and the test option is used.
-
test_target_type
Use this option to supply the target type to test a global credential. This is mandatory when the scope is global and the test option is used.
-
input_file
Use this option to supply sensitive property values from the file.
For more information about the input_file parameter, see -input_file Syntax Guidelines.
-
properties_file
Use this option to pass all parameters from the file. Values given on the command line take precedence.
-
attributes
Specify credential columns as follows:
colname:colvalue;colname:colvalue
You can change the separator value using -separator=attributes=<newvalue>, and you can change the subseperator value using -subseparator=attributes=<newvalue>.
-
remove_old_attributes
Unsets all existing credential column values.
Examples
Example 1
This example updates credentials to foo and bar:
emcli modify_named_credential -cred_name=NC1 -attributes="HostUserName:foo;HostPassword:bar"
Example 2
This example reads the password from the mypasswordfile.txt file.
emcli modify_named_credential -cred_name=NC1 -attributes="HostUserName:foo;HostPassword:tag" -input_file="tag:mypasswordfile.txt"