Backup-AzKeyVaultSecret

  • Başvuru
Modül:
Az.KeyVault

Anahtar kasasında bir gizli diziyi yedekler.

Syntax

Backup-AzKeyVaultSecret
      [-VaultName] <String>
      [-Name] <String>
      [[-OutputFile] <String>]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-AzKeyVaultSecret
      [-InputObject] <PSKeyVaultSecretIdentityItem>
      [[-OutputFile] <String>]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Backup-AzKeyVaultSecret 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-AzKeyVaultSecret cmdlet'ini kullanın ve ardından Restore-AzKeyVaultSecret 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

Backup-AzKeyVaultSecret -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

Backup-AzKeyVaultSecret -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

$secret = Get-AzKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret'
Backup-AzKeyVaultSecret -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:AzContext, 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

PSKeyVaultSecretIdentityItem

Çıkışlar

String