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"