Exercise 1 - Create a Credential


Create a credential that can be used to access all of the machines in your domain. For example, you might create the credential using the user name and password pair that applies to a service account within the domain.

Try it yourself

Create a credential named Sample Credential by submitting a POST request similar to the following:

Change the userName and password values as needed.

Postman example

			"name":"Sample Credential",


PowerShell script example

$credentialUrl = "https://localhost:3121/st/console/api/v1.0/credentials"
			$credential = Get-Credential
			$credentialBody = @{
			name = "Sample Credential" ;
			password = @{ClearText = "SamplePW" };
			username = "Admin"
			} | ConvertTo-Json -Depth 99
		Invoke-RestMethod -Method Post -Credential $credential -URI $credentialUrl -Body $credentialBody -ContentType "application/json" | ConvertTo-Json -Depth 99

For information on creating a credential using a secure password rather than a clear text password, see function Add-Credential in the Start-to-Finish Example.


The result is a JSON-formatted response similar to the following:

        "id": "ce45a98c-e8f0-4f88-a972-d66f99a9ef03",
        "links": {
        "self": {
        "href": "https://device-name.example.com:3121/st/console/api/v1.0/credentials/ce45a98c-e8f0-4f88-a972-d66f99a9ef03"
        "name": "Sample Credential",
        "userName": "Admin"