Register-PSSMSecretVault

SecretManagement: Registers a new secret vault

Script

#Requires -Version 5.1
#Requires -Modules Microsoft.PowerShell.SecretManagement, Microsoft.PowerShell.SecretStore

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [string]$VaultName,

    [string]$Description,
    [switch]$DefaultVault,
    [switch]$OverwriteExistingVault
)

Process {
    try {
        $cmdArgs = @{ ErrorAction = 'Stop'; ModuleName = 'Microsoft.PowerShell.SecretStore'; Name = $VaultName; AllowClobber = $OverwriteExistingVault; DefaultVault = $DefaultVault; Confirm = $false; PassThru = $null }
        if ($PSBoundParameters.ContainsKey('Description')) { $cmdArgs.Add('Description', $Description) }
        $result = Register-SecretVault @cmdArgs -ErrorAction Stop | Select-Object *
        if ($null -ne $result) { $result | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format "yyyy-MM-dd HH:mm:ss") -PassThru -Force }
    }
    catch { throw }
}

Customize

VaultName string

Name of the new vault

Description string

Optional description for the vault

DefaultVault switch

Off

Set the new vault as the default vault

OverwriteExistingVault switch

Off

Overwrite an existing registered vault with the same name