Backup-AzureKeyVaultCertificate

  • Referensi
Modul:
AzureRM.KeyVault

Mencadangkan sertifikat dalam brankas kunci.

Penting

Karena modul Az PowerShell sekarang memiliki semua kemampuan modul AzureRM PowerShell dan lebih banyak lagi, kami akan menghentikan modul AzureRM PowerShell pada 29 Februari 2024.

Untuk menghindari gangguan layanan, perbarui skrip Anda yang menggunakan modul AzureRM PowerShell untuk menggunakan modul Az PowerShell paling lambat 29 Februari 2024. Untuk memperbarui skrip Anda secara otomatis, ikuti panduan memulai cepat.

Sintaks

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

Deskripsi

Cmdlet Backup-AzureKeyVaultCertificate mencadangkan sertifikat tertentu dalam brankas kunci dengan mengunduhnya dan menyimpannya dalam file. Jika sertifikat memiliki beberapa versi, semua versinya akan disertakan dalam cadangan. Karena konten yang diunduh dienkripsi, konten tidak dapat digunakan di luar Azure Key Vault. Anda dapat memulihkan sertifikat yang dicadangkan ke brankas kunci apa pun dalam langganan tempat sertifikat dicadangkan, selama vault berada dalam geografi Azure yang sama. Alasan umum untuk menggunakan cmdlet ini adalah:

  • Anda ingin menyimpan salinan sertifikat offline jika Anda secara tidak sengaja menghapus yang asli dari vault.

  • Anda membuat sertifikat menggunakan Key Vault dan sekarang ingin mengkloning objek ke wilayah Azure yang berbeda, sehingga Anda dapat menggunakannya dari semua instans aplikasi terdistribusi Anda. Gunakan cmdlet Backup-AzureKeyVaultCertificate untuk mengambil sertifikat dalam format terenkripsi lalu gunakan cmdlet Restore-AzureKeyVaultCertificate dan tentukan brankas kunci di wilayah kedua.

Contoh

Contoh 1: Mencadangkan sertifikat dengan nama file yang dihasilkan secara otomatis

PS C:\Users\username\> Backup-AzureKeyVaultCertificate -VaultName 'mykeyvault' -Name 'mycert'

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

Perintah ini mengambil sertifikat bernama MyCert dari brankas kunci bernama MyKeyVault dan menyimpan cadangan sertifikat tersebut ke file yang secara otomatis dinamai untuk Anda, dan menampilkan nama file.

Contoh 2: Mencadangkan sertifikat ke nama file tertentu

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

C:\Backup.blob

Perintah ini mengambil sertifikat bernama MyCert dari brankas kunci bernama MyKeyVault dan menyimpan cadangan sertifikat tersebut ke file bernama Backup.blob.

Contoh 3: Cadangkan sertifikat yang diambil sebelumnya ke nama file tertentu, menimpa file tujuan tanpa meminta.

PS C:\> $cert = Get-AzureKeyVaultCertificate -VaultName 'MyKeyVault' -Name 'MyCert'
PS C:\> Backup-AzureKeyVaultCertificate -Certificate $cert -OutputFile 'C:\Backup.blob' -Force

C:\Backup.blob

Perintah ini membuat cadangan sertifikat bernama $cert. Nama di vault bernama $cert. VaultName ke file bernama Backup.blob, diam-diam menimpa file jika sudah ada.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

Timpa file yang diberikan jika ada

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

Rahasia untuk dicadangkan, disalurkan dari output panggilan pengambilan.

Type:PSKeyVaultCertificateIdentityItem
Aliases:Certificate
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

Nama rahasia. Cmdlet membangun FQDN rahasia dari nama brankas, lingkungan dan nama rahasia yang saat ini dipilih.

Type:String
Aliases:SecretName
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OutputFile

File output. File output untuk menyimpan cadangan sertifikat. Jika tidak ditentukan, nama file default akan dibuat.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VaultName

Nama vault. Cmdlet membangun FQDN vault berdasarkan nama dan lingkungan yang saat ini dipilih.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

PSKeyVaultCertificateIdentityItem

Parameter: InputObject (ByValue)

Output

String