Store/New-CredentialStore.ps1
|
function New-CredentialStore { <# .SYNOPSIS Creates a new credential store File .DESCRIPTION You need to run this script first to create a new credential store before you try to save new credentials with New-CredentialStoreItem. .PARAMETER Path Define a location for the new shared CredentialStore. The default store will be created in $Env:ProgramData\PSCredentialStore dir. .PARAMETER Shared Creates a CredentialStore in the Shared mode. This enables you to read the CredentialStore Items on different systems or profiles. In addition you can optionally provide a custom path wit the -Path parameter. .PARAMETER Force Use this switch to reset an existing store. The complete content will be wiped. .INPUTS [None] .OUTPUTS [None] .EXAMPLE New-CredentialStore # Creates a new private CredentialStore .EXAMPLE New-CredentialStore -Force # Resets an existing private CredentialStore .EXAMPLE New-CredentialStore -Shared # Creates a new shared CredentialStore .EXAMPLE New-CredentialStore -Shared -Path "C:\TMP\CredentialStore.json" # Creates a new shared CredentialStore in the given location. .NOTES File Name : New-CredentialStore.ps1 Author : Marco Blessing - marco.blessing@googlemail.com Requires : .LINK https://github.com/OCram85/PSCredentialStore #> [CmdletBinding(DefaultParameterSetName = "Private")] param( [Parameter(Mandatory = $false, ParameterSetName = "Shared")] [switch]$Shared, [Parameter(Mandatory = $false, ParameterSetName = "Shared")] [ValidateNotNullOrEmpty()] [string]$Path = "{0}\PSCredentialStore\CredentialStore.json" -f $env:ProgramData, [Parameter(Mandatory = $false, ParameterSetName = "Private")] [Parameter(Mandatory = $false, ParameterSetName = "Shared")] [switch]$Force ) # Lets get the current Date in a human readable format. $CurrentDate = Get-Date -UFormat "%Y-%m-%d %H:%M:%S" # Set latest Credential Store version Set-Variable -Name "CSVersion" -Value "1.2.0" -Option Constant # Set the CredentialStore path for private mode. Write-Debug ("ParameterSetName: {0}" -f $PSCmdlet.ParameterSetName) if ($PSCmdlet.ParameterSetName -eq "Private") { $Path = "{0}\CredentialStore.json" -f $Env:APPDATA } # Test if in the given store already a CredentialStore exists. Write-Verbose "Test if there is already a credential store." if ((Test-CredentialStore -Path $Path) -and ($Force -ne $true)) { $MessageParam = @{ Message = "The given file already exists. Use the 'Force' switch to override the existing store." ErrorAction = "Stop" } Write-Error @MessageParam } # We need to use the IDictionary to keep the property sorting in the object. $ObjProperties = [ordered]@{ Version = $CSVersion Creation = $CurrentDate } if ($PSCmdlet.ParameterSetName -eq "Shared") { $ObjProperties.Type = "Shared" # Check if a ChallengeFile already exists. We don't want to overide it. # Otherwise previous created CredentialStores couln't be decrypted anymore. if (-not (Test-ChallengeFile)) { Set-ChallengeFile } } else { $ObjProperties.Type = "Private" } # Create a new object for easy conversion into a json file $CredentialStoreObj = New-Object -TypeName psobject -Property $ObjProperties try { ConvertTo-Json -InputObject $CredentialStoreObj | Out-File -FilePath $Path } catch [System.Exception] { $_.Exception | Format-List -Force | Out-String | Write-Error -ErrorAction Stop } } |