Backup-AzKeyVaultSecret

  • Başvuru
Modül:
Az.KeyVault

Anahtar kasasında bir gizli diziyi yedekler.

Sözdizimi

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.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Varsa, çıktı dosyasının üzerine yazmadan önce sizden onay ister.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InputObject

Bir alma çağrısının çıkışından yedeklenecek, işlem hattı oluşturulacak gizli dizi.

Tür:PSKeyVaultSecretIdentityItem
Diğer adlar:Secret
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Yedeklene gizli dizinin adını belirtir.

Tür:String
Diğer adlar:SecretName
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:2
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-VaultName

Yedeklemek için gizli diziyi içeren anahtar kasasının adını belirtir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

PSKeyVaultSecretIdentityItem

Çıkışlar

String