2017-09-21 13:32:15 +02:00
|
|
|
function Set-CredentialStoreItem {
|
|
|
|
<#
|
|
|
|
.SYNOPSIS
|
|
|
|
Changes the credentials for the given remote host in the store.
|
|
|
|
|
|
|
|
.DESCRIPTION
|
2019-04-29 16:05:43 +02:00
|
|
|
Use this function to update your already stored RemoteHost items.
|
2017-09-21 13:32:15 +02:00
|
|
|
|
|
|
|
.PARAMETER Path
|
|
|
|
Define the store in which your given host entry already exists.
|
|
|
|
|
|
|
|
.PARAMETER RemoteHost
|
|
|
|
Specify the host you for which you would like to change the credentials.
|
|
|
|
|
|
|
|
.PARAMETER Identifier
|
|
|
|
Defaults to "". Specify a string, which separates two CredentialStoreItems for the
|
|
|
|
same hostname.
|
|
|
|
|
|
|
|
.PARAMETER Shared
|
|
|
|
Switch to shared mode with this param. This enforces the command to work with a shared CredentialStore which
|
|
|
|
can be decrypted across systems.
|
|
|
|
|
2019-04-29 16:05:43 +02:00
|
|
|
.PARAMETER Credential
|
|
|
|
Provided the new credentials you want to update inside the RemoteHost item.
|
|
|
|
|
2017-09-21 13:32:15 +02:00
|
|
|
.INPUTS
|
|
|
|
[None]
|
|
|
|
|
|
|
|
.OUTPUTS
|
|
|
|
[None]
|
|
|
|
|
|
|
|
.EXAMPLE
|
|
|
|
Set-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local"
|
2019-04-29 16:05:43 +02:00
|
|
|
|
|
|
|
.EXAMPLE
|
2017-09-21 13:32:15 +02:00
|
|
|
Set-CredentialStoreItem -Path "C:\TMP\mystore.json" -RemoteHost "esx01.myside.local" -Identifier svc
|
|
|
|
|
|
|
|
.NOTES
|
2019-04-29 16:05:43 +02:00
|
|
|
- File Name : Set-CredentialStoreItem.ps1
|
|
|
|
- Author : Marco Blessing - marco.blessing@googlemail.com
|
|
|
|
- Requires :
|
2017-09-21 13:32:15 +02:00
|
|
|
|
|
|
|
.LINK
|
|
|
|
https://github.com/OCram85/PSCredentialStore
|
|
|
|
#>
|
|
|
|
|
|
|
|
[CmdletBinding(DefaultParameterSetName = "Private")]
|
|
|
|
param(
|
|
|
|
[Parameter(Mandatory = $true, ParameterSetName = "Private")]
|
|
|
|
[Parameter(Mandatory = $true, ParameterSetName = "Shared")]
|
|
|
|
[string]$RemoteHost,
|
|
|
|
|
|
|
|
[Parameter(Mandatory = $false, ParameterSetName = "Private")]
|
|
|
|
[Parameter(Mandatory = $false, ParameterSetName = "Shared")]
|
|
|
|
[string]$Identifier,
|
|
|
|
|
2018-03-21 14:32:32 +01:00
|
|
|
[Parameter(Mandatory = $false, ValueFromPipeline = $true)]
|
|
|
|
[ValidateNotNullOrEmpty()]
|
|
|
|
[PSCredential]$Credential,
|
|
|
|
|
2019-01-16 12:55:29 +01:00
|
|
|
[Parameter(Mandatory = $true, ParameterSetName = "Shared")]
|
|
|
|
[switch]$Shared,
|
|
|
|
|
2017-09-21 13:32:15 +02:00
|
|
|
[Parameter(Mandatory = $false, ParameterSetName = "Shared")]
|
2019-01-16 12:55:29 +01:00
|
|
|
[ValidateNotNullOrEmpty()]
|
|
|
|
[string]$Path
|
2017-09-21 13:32:15 +02:00
|
|
|
)
|
|
|
|
|
2019-01-16 12:55:29 +01:00
|
|
|
begin {
|
|
|
|
# Set the CredentialStore for private, shared or custom mode.
|
|
|
|
Write-Debug ("ParameterSetName: {0}" -f $PSCmdlet.ParameterSetName)
|
|
|
|
if ($PSCmdlet.ParameterSetName -eq "Private") {
|
|
|
|
$Path = Get-DefaultCredentialStorePath
|
|
|
|
}
|
|
|
|
elseif ($PSCmdlet.ParameterSetName -eq "Shared") {
|
|
|
|
if (!($PSBoundParameters.ContainsKey('Path'))) {
|
|
|
|
$Path = Get-DefaultCredentialStorePath -Shared
|
|
|
|
}
|
2017-09-21 13:32:15 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-01-16 12:55:29 +01:00
|
|
|
process {
|
|
|
|
# Lets do a quick test on the given CredentialStore.
|
|
|
|
if (-not(Test-CredentialStore -Shared -Path $Path)) {
|
|
|
|
$MessageParams = @{
|
|
|
|
Message = "Could not add anything into the given CredentailStore."
|
|
|
|
ErrorAction = "Stop"
|
|
|
|
}
|
|
|
|
Write-Error @MessageParams
|
|
|
|
}
|
2017-09-21 13:32:15 +02:00
|
|
|
|
2019-01-16 12:55:29 +01:00
|
|
|
# Read the file content based on the given ParameterSetName
|
|
|
|
$CSContent = Get-CredentialStore -Shared -Path $Path
|
2017-09-21 13:32:15 +02:00
|
|
|
|
2019-01-16 12:55:29 +01:00
|
|
|
$CurrentDate = Get-Date -UFormat "%Y-%m-%d %H:%M:%S"
|
2017-09-21 13:32:15 +02:00
|
|
|
|
2019-01-16 12:55:29 +01:00
|
|
|
if ($Identifier -ne "") {
|
|
|
|
$CredentialName = $RemoteHost = "{0}/{1}" -f $Identifier, $RemoteHost
|
2017-09-21 13:32:15 +02:00
|
|
|
}
|
|
|
|
else {
|
2019-01-16 12:55:29 +01:00
|
|
|
$CredentialName = $RemoteHost
|
2017-09-21 13:32:15 +02:00
|
|
|
}
|
2019-01-16 12:55:29 +01:00
|
|
|
|
|
|
|
if (-not($Credential)) {
|
|
|
|
$Credential = Get-Credential -Message $CredentialName
|
2017-09-21 13:32:15 +02:00
|
|
|
}
|
2019-01-16 12:55:29 +01:00
|
|
|
|
|
|
|
if ($Credential.UserName) {
|
2019-04-29 16:05:43 +02:00
|
|
|
if ($null -eq $CSContent.PfxCertificate) {
|
|
|
|
$Cert = Get-CSCertificate -Type $CSContent.Type -Thumbprint $CSContent.Thumbprint
|
2019-01-16 12:55:29 +01:00
|
|
|
}
|
2019-04-29 16:05:43 +02:00
|
|
|
else {
|
|
|
|
$Cert = Get-PfxCertificate -FilePath $CSContent.PfxCertificate -ErrorAction Stop
|
2019-01-16 12:55:29 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
if (Get-Member -InputObject $CSContent -Name $CredentialName -Membertype Properties) {
|
|
|
|
$RSAKey = Get-RandomAESKey
|
|
|
|
$CSContent.$CredentialName.User = $Credential.UserName
|
|
|
|
$CSContent.$CredentialName.Password = ConvertFrom-SecureString -SecureString $Credential.Password -Key $RSAKey
|
|
|
|
$CSContent.$CredentialName.LastChange = $CurrentDate
|
|
|
|
$CSContent.$CredentialName.EncryptedKey = [Convert]::ToBase64String(
|
|
|
|
$Cert.PublicKey.Key.Encrypt(
|
|
|
|
$RSAKey,
|
|
|
|
[System.Security.Cryptography.RSAEncryptionPadding]::Pkcs1
|
|
|
|
)
|
|
|
|
)
|
|
|
|
ConvertTo-Json -InputObject $CSContent -Depth 5 | Out-File -FilePath $Path -Encoding utf8
|
|
|
|
}
|
|
|
|
}
|
|
|
|
Else {
|
2017-09-21 13:32:15 +02:00
|
|
|
$MessageParams = @{
|
2019-01-16 12:55:29 +01:00
|
|
|
Message = "Please Provide at least a valid user!"
|
|
|
|
ErrorAction = "Stop"
|
2017-09-21 13:32:15 +02:00
|
|
|
}
|
2019-01-16 12:55:29 +01:00
|
|
|
Write-Error @MessageParams
|
2017-09-21 13:32:15 +02:00
|
|
|
}
|
|
|
|
}
|
2019-01-16 12:55:29 +01:00
|
|
|
|
|
|
|
end {
|
|
|
|
|
2017-09-21 13:32:15 +02:00
|
|
|
}
|
|
|
|
}
|