Register-SecretVault

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

Esse cmdlet adiciona um cofre de extensão SecretManagement ao registro do cofre do usuário atual. Um cofre de extensões é um módulo do PowerShell que está em conformidade com o formato de cofre de extensão necessário. Esse cmdlet verifica se o módulo especificado atende aos requisitos de conformidade antes de adicioná-lo ao registro do cofre de extensão. Os cofres de extensão são registrados para o usuário atual e não afetam outros registros de cofre de usuário.

O primeiro cofre registrado com esse cmdlet é definido automaticamente como o cofre padrão, mesmo que o parâmetro DefaultVault não seja especificado.

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

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

Este exemplo registra um cofre de extensões Microsoft.PowerShell.SecretStore para o usuário atual. Ele usa o parâmetro DefaultVault para tornar o cofre registrado o cofre padrão para o usuário. Get-SecretVault lista todos os cofres registrados para o usuário, verificando se o cofre foi registrado e definido como o cofre padrão.

$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

Este exemplo registra um cofre de extensão Az.KeyVault para o usuário atual. O módulo Az.KeyVault precisa ser instalado anteriormente. Para o VaultParameters:

• AZKVaultName especifica o nome do Key Vault no Azure
• SubscriptionId especifica a ID da assinatura na qual o Key Vault é criado

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.