Backup-AzureKeyVaultSecret
Anahtar kasasında bir gizli diziyi yedekler.
Uyarı
AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.
AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.
Syntax
Backup-AzureKeyVaultSecret
[-VaultName] <String>
[-Name] <String>
[[-OutputFile] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Backup-AzureKeyVaultSecret
[-InputObject] <PSKeyVaultSecretIdentityItem>
[[-OutputFile] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Backup-AzureKeyVaultSecret cmdlet'i, bir anahtar kasasında belirtilen gizli diziyi indirip bir dosyada depolayarak yedekler. Gizli dizinin birden çok sürümü varsa, tüm sürümler yedeklemeye dahil edilir. İndirilen içerik şifrelendiğinden Azure Key Vault dışında kullanılamaz. Yedeklenen gizli diziyi, yedeklendiği abonelikteki herhangi bir anahtar kasasına geri yükleyebilirsiniz. Bu cmdlet'i kullanmanın tipik nedenleri şunlardır:
- Anahtar kasanızda gizli dizinizi yanlışlıkla silmeniz durumunda çevrimdışı bir kopyanızın olması için gizli dizinizin bir kopyasını emanet etmek istiyorsunuz.
- Bir anahtar kasasına gizli dizi eklediniz ve şimdi gizli diziyi farklı bir Azure bölgesine kopyalamak istiyorsunuz, böylece bunu dağıtılmış uygulamanızın tüm örneklerinden kullanabilirsiniz. Gizli diziyi şifrelenmiş biçimde almak için Backup-AzureKeyVaultSecret cmdlet'ini kullanın ve ardından Restore-AzureKeyVaultSecret cmdlet'ini kullanın ve ikinci bölgede bir anahtar kasası belirtin. (Bölgelerin aynı coğrafyaya ait olması gerektiğini unutmayın.)
Örnekler
Örnek 1: Otomatik olarak oluşturulan dosya adıyla gizli dizi yedekleme
PS C:\Users\username\> Backup-AzureKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret'
C:\Users\username\mykeyvault-mysecret-1527029447.01191
Bu komut MyKeyVault adlı anahtar kasasından MySecret adlı gizli diziyi alır ve bu gizli dizinin yedeğini sizin adınıza otomatik olarak adlandırılan bir dosyaya kaydeder ve dosya adını görüntüler.
Örnek 2: Gizli diziyi belirtilen bir dosya adına yedekleyerek, istemde bulunmadan var olan dosyanın üzerine yazma
PS C:\> Backup-AzureKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret' -OutputFile 'C:\Backup.blob' -Force
C:\Backup.blob
Bu komut MyKeyVault adlı anahtar kasasından MySecret adlı gizli diziyi alır ve bu gizli dizinin yedeğini Backup.blob adlı bir dosyaya kaydeder.
Örnek 3: Daha önce belirtilen dosya adına alınan bir gizli diziyi yedekleme
PS C:\> $secret = Get-AzureKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret'
PS C:\> Backup-AzureKeyVaultSecret -Secret $secret -OutputFile 'C:\Backup.blob'
C:\Backup.blob
Bu komut, gizli diziyi almak ve yedeklemesini Backup.blob adlı bir dosyaya kaydetmek için $secret nesnesinin kasa adını ve adını kullanır.
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Varsa, çıktı dosyasının üzerine yazmadan önce sizden onay ister.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Bir alma çağrısının çıkışından yedeklenecek, işlem hattı oluşturulacak gizli dizi.
Type: | PSKeyVaultSecretIdentityItem |
Aliases: | Secret |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Yedeklene gizli dizinin adını belirtir.
Type: | String |
Aliases: | SecretName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputFile
Yedekleme blobunun depolandığı çıkış dosyasını belirtir. Bu parametreyi belirtmezseniz, bu cmdlet sizin için bir dosya adı oluşturur. Var olan bir çıkış dosyasının adını belirtirseniz, işlem tamamlanmaz ve yedekleme dosyasının zaten var olduğunu belirten bir hata iletisi döndürür.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VaultName
Yedeklemek için gizli diziyi içeren anahtar kasasının adını belirtir.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
Parametreler: InputObject (ByValue)