Backup-AzureKeyVaultKey

  • Başvuru
Modül:
AzureRM.KeyVault

Anahtar kasasında bir anahtarı 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-AzureKeyVaultKey
      [-VaultName] <String>
      [-Name] <String>
      [[-OutputFile] <String>]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-AzureKeyVaultKey
      [-InputObject] <PSKeyVaultKeyIdentityItem>
      [[-OutputFile] <String>]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Backup-AzureKeyVaultKey cmdlet'i, bir anahtar kasasında belirtilen anahtarı indirip bir dosyada depolayarak yedekler. Anahtarın 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 anahtarı, yedeklendiği abonelikteki herhangi bir anahtar kasasına geri yükleyebilirsiniz. Bu cmdlet'i kullanmanın tipik nedenleri şunlardır:

  • Anahtarınızı yanlışlıkla anahtar kasanızda silmeniz durumunda çevrimdışı bir kopyanızın olması için anahtarınızın bir kopyasını emanet etmek istiyorsunuz.

  • Key Vault kullanarak bir anahtar oluşturdunuz ve şimdi anahtarı farklı bir Azure bölgesine kopyalamak istiyorsunuz, böylece dağıtılmış uygulamanızın tüm örneklerinden kullanabilirsiniz. Anahtarı şifreli biçimde almak için Backup-AzureKeyVaultKey cmdlet'ini kullanın ve ardından Restore-AzureKeyVaultKey cmdlet'ini kullanarak ikinci bölgede bir anahtar kasası belirtin.

Örnekler

Örnek 1: Otomatik olarak oluşturulan dosya adıyla anahtarı yedekleme

PS C:\Users\username\> Backup-AzureKeyVaultKey -VaultName 'MyKeyVault' -Name 'MyKey'

C:\Users\username\mykeyvault-mykey-1527029447.01191

Bu komut MyKeyVault adlı anahtar kasasından MyKey adlı anahtarı alır ve bu anahtarın yedeğini sizin adınıza otomatik olarak adlandırılan bir dosyaya kaydeder ve dosya adını görüntüler.

Örnek 2: Anahtarı belirtilen dosya adına yedekleme

PS C:\> Backup-AzureKeyVaultKey -VaultName 'MyKeyVault' -Name 'MyKey' -OutputFile 'C:\Backup.blob'

C:\Backup.blob

Bu komut MyKeyVault adlı anahtar kasasından MyKey adlı anahtarı alır ve bu anahtarın yedeğini Backup.blob adlı bir dosyaya kaydeder.

Örnek 3: Önceden alınan bir anahtarı belirtilen dosya adına yedekleyin ve sormadan hedef dosyanın üzerine yazın.

PS C:\> $key = Get-AzureKeyVaultKey -VaultName 'MyKeyVault' -Name 'MyKey'
PS C:\> Backup-AzureKeyVaultKey -Key $key -OutputFile 'C:\Backup.blob' -Force

C:\Backup.blob

Bu komut, $key adlı anahtarın yedeğini oluşturur. Kasadaki adı $key. Backup.blob adlı bir dosyaya VaultName ekleyin ve zaten varsa dosyanın üzerine sessizce yazın.

Parametreler

-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

-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 verilen dosyanın üzerine yaz

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

-InputObject

Yedeklemek için anahtar paketi, bir alma çağrısının çıkışından işlem hattına alınır.

Type:PSKeyVaultKeyIdentityItem
Aliases:Key
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Yedeklene anahtarın adını belirtir.

Type:String
Aliases:KeyName
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

Yedek anahtar 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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

PSKeyVaultKeyIdentityItem

Parametreler: InputObject (ByValue)

Çıkışlar

String