Aracılığıyla paylaş


Register-SecretVault

Geçerli kullanıcı için secretmanagement uzantısı kasa modülünü kaydeder.

Syntax

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

Description

Bu cmdlet, geçerli kullanıcının kasa kayıt defterine bir SecretManagement uzantısı kasası ekler. Uzantı kasası, gerekli uzantı kasası biçimine uyan bir PowerShell modülüdür. Bu cmdlet, uzantı kasası kayıt defterine eklemeden önce belirtilen modülün uyumluluk gereksinimlerini karşıladığını doğrular. Uzantı kasaları geçerli kullanıcıya kaydedilir ve diğer kullanıcı kasası kayıtlarını etkilemez.

Bu cmdlet ile kaydedilen ilk kasa, DefaultVault parametresi belirtilmemiş olsa bile otomatik olarak varsayılan kasa olarak tanımlanır.

Örnekler

Örnek 1

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

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

Bu örnek, geçerli kullanıcı için bir Microsoft.PowerShell.SecretStore uzantısı kasasını kaydeder. Kayıtlı kasayı kullanıcının varsayılan kasası yapmak için DefaultVault parametresini kullanır. Get-SecretVault kullanıcının tüm kayıtlı kasalarını listeler ve kasanın kaydedilip varsayılan kasa olarak ayarlandığını doğrular.

Örnek 2

$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

Bu örnek, geçerli kullanıcı için bir Az.KeyVault uzantı kasası kaydeder. Az.KeyVault modülünün önceden yüklenmiş olması gerekir. VaultParameters için:

  • AZKVaultNameAzure'da Key Vault adını belirtir
  • SubscriptionIdKey Vault oluşturulduğu aboneliğin kimliğini belirtir

Parametreler

-AllowClobber

Belirtilirse, cmdlet'in aynı ada sahip mevcut kayıtlı uzantı kasasının üzerine yazmasına izin verir.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultVault

Belirtilirse, yeni uzantı kasasını geçerli kullanıcı için varsayılan kasa olarak ayarlar.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Kasayı açıklar. Bu değer, kasa kayıt defteri bilgilerine eklenir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

Uzantı kasasını uygulayan PowerShell modülünün adını belirtir. Modülün adını veya modül yolunu girin. Bir ad belirtirseniz, PowerShell bu adı bilinen modül yollarında arar. Bir yol belirtirseniz PowerShell bu yolu modül için arar.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Uzantı kasasının adını belirtir. Herhangi bir ad belirtilmezse, kasa adı olarak modül adı kullanılır.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Cmdlet'in başarıyla kaydedilen uzantı kasası için SecretVaultInfo nesnesini döndürmesi gerektiğini gösterir. Varsayılan olarak bu cmdlet herhangi bir çıkış döndürmez.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultParameters

Uzantı kasası tarafından parametre olarak kullanılan isteğe bağlı anahtar-değer çiftlerini içeren bir Hashtable nesnesi belirtir. Bu parametreler isteğe bağlıdır. Hangi değerlerin gerekli olduğunu görmek için kasa uzantısı modülünün belgelerine bakın.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

None

Çıkışlar

None