Backup-AzKeyVaultSecret

Modül:
Az.KeyVault Module

Anahtar kasasında bir gizli diziyi yedekler.

Syntax

BySecretName (Varsayılan) 

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

BySecretUri 

Backup-AzKeyVaultSecret
    [-Id] <String>
    [[-OutputFile] <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BySecret 

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.

Örnek 4: Bir gizli diziyi otomatik olarak oluşturulan dosya adıyla yedekleme (Uri kullanarak)

Backup-AzKeyVaultSecret -Id 'https://MyKeyVault.vault.azure.net:443/secrets/MySecret'

Parametreler

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

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

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Force

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Id

KeyVault Gizli Dizisinin URI'si. Lütfen şu biçime uydığından emin olun: https://<vault-name>.vault.azure.net/secrets/<secret-name>/<version>

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:SecretId

Parametre kümeleri

BySecretUri
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-InputObject

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

Parametre özellikleri

Tür:PSKeyVaultSecretIdentityItem
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Gizli

Parametre kümeleri

BySecret
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

Yedeklene gizli dizinin adını belirtir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Gizli Dizi Adı

Parametre kümeleri

BySecretName
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:2
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-VaultName

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

BySecretName
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

PSKeyVaultSecretIdentityItem

Çıkışlar

String