Dela via


Backup-AzureKeyVaultCertificate

Säkerhetskopierar ett certifikat i ett nyckelvalv.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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>]

Description

Cmdleten Backup-AzureKeyVaultCertificate säkerhetskopierar ett angivet certifikat i ett nyckelvalv genom att ladda ned det och lagra det i en fil. Om certifikatet har flera versioner inkluderas alla dess versioner i säkerhetskopian. Eftersom det nedladdade innehållet är krypterat kan det inte användas utanför Azure Key Vault. Du kan återställa ett säkerhetskopierat certifikat till valfritt nyckelvalv i prenumerationen som det säkerhetskopierades från, så länge valvet finns i samma Azure-geografi. Vanliga orsaker till att använda den här cmdleten är:

  • Du vill behålla en offlinekopia av certifikatet om du av misstag tar bort originalet från valvet.

  • Du har skapat ett certifikat med Key Vault och vill nu klona objektet till en annan Azure-region, så att du kan använda det från alla instanser av ditt distribuerade program. Använd cmdleten Backup-AzureKeyVaultCertificate för att hämta certifikatet i krypterat format och sedan använda cmdleten Restore-AzureKeyVaultCertificate och ange ett nyckelvalv i den andra regionen.

Exempel

Exempel 1: Säkerhetskopiera ett certifikat med ett automatiskt genererat filnamn

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

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

Det här kommandot hämtar certifikatet MyCert från nyckelvalvet med namnet MyKeyVault och sparar en säkerhetskopia av certifikatet till en fil som automatiskt namnges åt dig och visar filnamnet.

Exempel 2: Säkerhetskopiera ett certifikat till ett angivet filnamn

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

C:\Backup.blob

Det här kommandot hämtar certifikatet MyCert från nyckelvalvet med namnet MyKeyVault och sparar en säkerhetskopia av certifikatet till en fil med namnet Backup.blob.

Exempel 3: Säkerhetskopiera ett tidigare hämtat certifikat till ett angivet filnamn och skriv över målfilen utan att fråga.

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

C:\Backup.blob

Det här kommandot skapar en säkerhetskopia av certifikatet med namnet $cert. Namn i valvet med namnet $cert. VaultName till en fil med namnet Backup.blob, som tyst skriver över filen om den redan finns.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Skriv över den angivna filen om den finns

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Hemlighet som ska säkerhetskopieras, pipelines in från utdata från ett hämtningsanrop.

Typ:PSKeyVaultCertificateIdentityItem
Alias:Certificate
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Hemligt namn. Cmdlet konstruerar FQDN för en hemlighet från valvnamnet, som för närvarande är valt miljö och hemligt namn.

Typ:String
Alias:SecretName
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OutputFile

Utdatafil. Utdatafilen för att lagra säkerhetskopian av certifikatet. Om inget anges genereras ett standardfilnamn.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VaultName

Valvnamn. Cmdleten konstruerar FQDN för ett valv baserat på namnet och den aktuella miljön.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSKeyVaultCertificateIdentityItem

Parametrar: InputObject (ByValue)

Utdata

String