Backup-AzKeyVaultCertificate

Säkerhetskopierar ett certifikat i ett nyckelvalv.

Syntax

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

Description

Cmdleten Backup-AzKeyVaultCertificate 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-AzKeyVaultCertificate för att hämta certifikatet i krypterat format och sedan använda cmdleten Restore-AzKeyVaultCertificate och ange ett nyckelvalv i den andra regionen.

Exempel

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

Backup-AzKeyVaultCertificate -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

Backup-AzKeyVaultCertificate -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.

$cert = Get-AzKeyVaultCertificate -VaultName 'MyKeyVault' -Name 'MyCert'
Backup-AzKeyVaultCertificate -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.

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

-DefaultProfile

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

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

-Force

Skriv över den angivna filen om den finns

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

-InputObject

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

Type:PSKeyVaultCertificateIdentityItem
Aliases:Certificate
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-OutputFile

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

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

-VaultName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

Indata

PSKeyVaultCertificateIdentityItem

Utdata

String