Register-SecretVault

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

Este cmdlet agrega un almacén de extensiones de SecretManagement al registro del almacén del usuario actual. Un almacén de extensiones es un módulo de PowerShell que se ajusta al formato de almacén de extensiones necesario. Este cmdlet comprueba que el módulo especificado cumple los requisitos de conformidad antes de agregarlo al registro del almacén de extensiones. Los almacenes de extensiones se registran para el usuario actual y no afectan a los registros de otros almacenes de usuario.

El primer almacén registrado con este cmdlet se define automáticamente como el almacén predeterminado, incluso si no se especifica el parámetro DefaultVault .

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

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

En este ejemplo se registra un almacén de extensiones de Microsoft.PowerShell.SecretStore para el usuario actual. Usa el parámetro DefaultVault para que el almacén registrado sea el almacén predeterminado para el usuario. Get-SecretVault enumera todos los almacenes registrados para el usuario, comprobando que el almacén se registró y estableció como almacén predeterminado.

$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

En este ejemplo se registra un almacén de extensiones de Az.KeyVault para el usuario actual. El módulo Az.KeyVault debe instalarse antes. Para VaultParameters:

• AZKVaultName especifica el nombre de Key Vault en Azure
• SubscriptionId especifica el identificador de la suscripción en la que se crea key Vault.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.