Register-SecretVault

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

Met deze cmdlet wordt een SecretManagement-extensiekluis toegevoegd aan het kluisregister van de huidige gebruiker. Een extensiekluis is een PowerShell-module die voldoet aan de vereiste indeling van de extensiekluis. Met deze cmdlet wordt gecontroleerd of de opgegeven module voldoet aan de nalevingsvereisten voordat deze wordt toegevoegd aan het register van de extensiekluis. Extensiekluizen worden geregistreerd voor de huidige gebruiker en hebben geen invloed op andere registraties van gebruikerskluizen.

De eerste kluis die met deze cmdlet is geregistreerd, wordt automatisch gedefinieerd als de standaardkluis, zelfs als de parameter DefaultVault niet is opgegeven.

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

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

In dit voorbeeld wordt een Microsoft.PowerShell.SecretStore extensiekluis voor de huidige gebruiker geregistreerd. Hierbij wordt de parameter DefaultVault gebruikt om de geregistreerde kluis de standaardkluis voor de gebruiker te maken. Get-SecretVault geeft een lijst weer van alle geregistreerde kluizen voor de gebruiker, waarbij wordt gecontroleerd of de kluis is geregistreerd en ingesteld als de standaardkluis.

$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

In dit voorbeeld wordt een Az.KeyVault-extensiekluis voor de huidige gebruiker geregistreerd. De module Az.KeyVault moet eerder worden geïnstalleerd. Voor de VaultParameters:

• AZKVaultName geeft de naam van de Sleutelkluis in Azure op
• SubscriptionId geeft de id op van het abonnement waarin de Key Vault wordt gemaakt

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.