test setcreds

Sets or clears the credentials that are used to run diagnostic tests on the HPC cluster.

For examples of how to use this command, see Examples.

Syntax

test setcreds [/username:[<domain>\]user_name] [/password:<password>]   
[/clear[:{true | false}] [/server:<server_name>]  
  
test setcreds [/thumbprint] {/? | /help}  
  

Parameters

Parameter Description
/username:[<domain>\]user_name Specifies the user name for the account that should be used to run diagnostic tests on the HPC cluster. If you specify the /username parameter without specifying the /password parameter, the test setcreds command prompts you for a password.

If you specify the /clear parameter, the test setcreds command ignores the /username parameter.
/password:<password> Specifies the password for the account that should be used to run diagnostic tests on the HPC cluster. If you do not specify the /password parameter when you specify the /username parameter, the test setcreds command prompts you for a password.

If you specify the /clear parameter, the test setcreds command ignores the /password parameter.
/clear[:{true | false} Specifies whether to clear the stored credentials used to run diagnostic tests on the HPC cluster.

The /clear and /clear:true parameters are equivalent and specify that the test setcreds command should clear the credentials that are used to run diagnostic tests on the HPC cluster. The /clear:false parameter specifies that the test setcreds command should not clear the credentials that are used to run diagnostic tests on the HPC cluster.

If you specify /clear or /clear:true, the test setcreds command ignores the /username and /password parameters.
/server:<server_name> Specifies the host name or IP address of the server that hosts the HPC Diagnostics Service for the HPC cluster for which you want to specify the credentials used to run diagnostic tests. The value must be a valid computer name or IP address. If you do not specify the /server parameter, this command uses the head node that the CCP_SCHEDULER environment variable specifies.
/thumbprint Specifies the thumbprint of a certificate for soft card authentication. Note: This parameter was introduced in HPC Pack 2012. It is not supported in previous versions.
/? Displays Help at the command prompt.
/help Displays Help at the command prompt.

Remarks

  • If you run the test setcreds command without the /username, /clear, or /clear:true parameter, the command prompts you for the user name and password.

  • You must be a cluster administrator to run this command successfully.

Examples

To set the credentials that are used to run diagnostic tests on the HPC cluster, type the following and then type the user name and password when prompted:

test setcreds  

To set the credentials that are used to run diagnostic tests on the HPC cluster to those for the account with a user name of someone in the CONTOSO domain, type the following and then type password for that account when prompted:

test setcreds /username:CONTOSO\someone  

To clear the credentials that are used to run diagnostic tests on the HPC, type:

test setcreds /clear  

Additional references