Register-SecretVault

Register-SecretVault
    [-ModuleName] <String>
    [[-Name] <String>]
    [-VaultParameters <Hashtable>]
    [-DefaultVault]
    [-AllowClobber]
    [-PassThru]
    [-Description <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Cette applet de commande ajoute un SecretManagement coffre d’extension au registre du coffre de l’utilisateur actuel. Un coffre d’extensions est un module PowerShell conforme au format de coffre d’extension requis. Cette applet de commande vérifie que le module spécifié répond aux exigences de conformité avant de l’ajouter au registre du coffre d’extensions. Les coffres-forts d’extensions sont enregistrés pour l’utilisateur actuel et n’affectent pas les autres enregistrements de coffres-forts utilisateur.

Le premier coffre enregistré avec cette applet de commande est automatiquement défini comme coffre-fort par défaut, même si le paramètre DefaultVault n’est pas spécifié.

Register-SecretVault -Name LocalStore -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault
Get-SecretVault

VaultName  ModuleName                        IsDefaultVault
---------  ----------                        --------------
CredMan    Microsoft.PowerShell.CredManStore False
LocalStore Microsoft.PowerShell.SecretStore  True

Cet exemple enregistre un coffre d’extensions Microsoft.PowerShell.SecretStore pour l’utilisateur actuel. Il utilise le paramètre DefaultVault pour rendre le coffre inscrit le coffre par défaut pour l’utilisateur. Get-SecretVault répertorie tous les coffres inscrits pour l’utilisateur, en vérifiant que le coffre a été inscrit et défini comme coffre par défaut.

$parameters = @{
    Name = 'Azure'
    ModuleName = 'Az.KeyVault'
    VaultParameters = @{
        AZKVaultName = 'AzureKeyVault'
        SubscriptionId = (Get-AzContext).Subscription.Id
    }
    DefaultVault = $true
}
Register-SecretVault @parameters
Get-SecretVault

Name  ModuleName  IsDefaultVault
----  ----------  --------------
Azure Az.KeyVault True

Cet exemple enregistre un coffre d’extension Az.KeyVault pour l’utilisateur actuel. Le module Az.KeyVault doit être installé avant. Pour les VaultParameters :

• AZKVaultName spécifie le nom du coffre de clés sur Azure
• SubscriptionId spécifie l’ID de l’abonnement dans lequel le coffre de clés est créé

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.