test setcreds
Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2
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 Microsoft® 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