Register-SecretVault

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

To polecenie cmdlet dodaje magazyn SecretManagement rozszerzenia do rejestru magazynu bieżącego użytkownika. Magazyn rozszerzeń to moduł programu PowerShell zgodny z wymaganym formatem magazynu rozszerzeń. To polecenie cmdlet sprawdza, czy określony moduł spełnia wymagania zgodności przed dodaniem go do rejestru magazynu rozszerzeń. Magazyny rozszerzeń są rejestrowane na bieżącego użytkownika i nie mają wpływu na rejestracje innych magazynów użytkowników.

Pierwszy magazyn zarejestrowany za pomocą tego polecenia cmdlet jest automatycznie definiowany jako magazyn domyślny, nawet jeśli parametr DefaultVault nie jest określony.

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

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

W tym przykładzie zarejestrowano magazyn rozszerzeń Microsoft.PowerShell.SecretStore dla bieżącego użytkownika. Używa on parametru DefaultVault, aby zarejestrowany magazyn był domyślnym magazynem dla użytkownika. Get-SecretVault wyświetla listę wszystkich zarejestrowanych magazynów dla użytkownika, sprawdzanie, czy magazyn został zarejestrowany i ustawiony jako magazyn domyślny.

$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

W tym przykładzie zarejestrowano magazyn rozszerzenia Az.KeyVault dla bieżącego użytkownika. Moduł Az.KeyVault należy zainstalować wcześniej. Dla VaultParameters:

• AZKVaultName określa nazwę usługi Key Vault na platformie Azure
• SubscriptionId określa identyfikator subskrypcji, w której utworzono usługę Key Vault

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.