Skip to main content

1E 8.1 (on-premises)

Using Credential Vault Credentials

Example of using credentials retrieved from the Windows Credential Vault in PowerShell to perform a privileged operation. In this example, we will use the credentials to join a workgroup computer to a domain.

Join a workgroup computer to a domain

We assume that we have already used the set-tachyoncredential cmdlet to send appropriately privileged credentials to a workgroup computer.

Note that the domain name in this PowerShell example is hard coded. You would of course want to pass this in as a parameter to the script.

We retrieve the credential from the credential vault, assuming that it was stored with the name 'AdminCreds'. This code is assumed to be run in the context of the account in which those credentials were stored, which almost certainly will be LocalSystem.

Having retrieved the credentials, we then need to convert them into a PSCredential object as they cannot be used directly in most PS commands that require credentials.

Why the credential vault returns a different object type is a mystery known only to Microsoft. However, you can easily convert by retrieving the account and password from the vault credential and then re-encoding them into a PSCredential object.

Having joined the domain, we force a reboot by using the 'start' command. Note that the obvious native PowerShell solution, which would use start-job and then sleeping for 30 seconds before using the restart-computer cmdlet, does not work as expected because, if this script is run from the Tachyon Client, then the PowerShell session is destroyed before the asynchronous job sleep command has completed. At that point, the entire asynchronous task is cancelled and the computer never reboots. Hence, we use 'start' to kick off a shutdown with a 30-second delay instead.

$vault = New-Object Windows.Security.Credentials.PasswordVault
$creds = $vault.RetrieveAll()
$mycred = $creds | where-object {$_.Resource -eq "AdminCreds"}
if ($null -eq $mycred)
        throw "The specified credentials could not be retrieved"

[securestring]$secPassword = convertto-securestring $myCred.Password -AsPlainText -Force
[pscredential]$credObject = new-object ($mycred.UserName,$secPassword)
Add-Computer -Domain urth.local -Credential $credObject
$a = @("/c","start", "shutdown","/r", "/t 30",'/c " "')
Start-Process "cmd" -ArgumentList $a