Backup-AzKeyVaultCertificate

Riferimento

Modulo:: Az.KeyVault

Esegue il backup di un certificato in un insieme di credenziali delle chiavi.

Sintassi

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

Descrizione

Il cmdlet Backup-AzKeyVaultCertificate esegue il backup di un certificato specificato in un insieme di credenziali delle chiavi scaricandolo e archiviandolo in un file. Se il certificato ha più versioni, tutte le versioni verranno incluse nel backup. Poiché il contenuto scaricato è crittografato, non può essere usato all'esterno di Azure Key Vault. È possibile ripristinare un certificato di cui è stato eseguito il backup in qualsiasi insieme di credenziali delle chiavi nella sottoscrizione da cui è stato eseguito il backup, purché l'insieme di credenziali si trovi nella stessa area geografica di Azure. I motivi tipici per usare questo cmdlet sono:

Si vuole conservare una copia offline del certificato nel caso in cui si elimini accidentalmente l'originale dall'insieme di credenziali.
È stato creato un certificato usando Key Vault e si vuole clonare l'oggetto in un'area di Azure diversa, in modo da poterlo usare da tutte le istanze dell'applicazione distribuita. Usare il cmdlet Backup-AzKeyVaultCertificate per recuperare il certificato in formato crittografato e quindi usare il cmdlet Restore-AzKeyVaultCertificate e specificare un insieme di credenziali delle chiavi nella seconda area.

Esempio

Esempio 1: Eseguire il backup di un certificato con un nome file generato automaticamente

Backup-AzKeyVaultCertificate -VaultName 'mykeyvault' -Name 'mycert'

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

Questo comando recupera il certificato denominato MyCert dall'insieme di credenziali delle chiavi denominato MyKeyVault e salva un backup del certificato in un file denominato automaticamente e visualizza il nome del file.

Esempio 2: Eseguire il backup di un certificato in un nome file specificato

Backup-AzKeyVaultCertificate -VaultName 'MyKeyVault' -Name 'MyCert' -OutputFile 'C:\Backup.blob'

C:\Backup.blob

Questo comando recupera il certificato denominato MyCert dall'insieme di credenziali delle chiavi denominato MyKeyVault e salva un backup del certificato in un file denominato Backup.blob.

Esempio 3: eseguire il backup di un certificato recuperato in precedenza in un nome di file specificato, sovrascrivendo il file di destinazione senza chiedere conferma.

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

C:\Backup.blob

Questo comando crea un backup del certificato denominato $cert. Nome nell'insieme di credenziali denominato $cert. VaultName in un file denominato Backup.blob, sovrascrivendo automaticamente il file, se esistente.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-Force

Sovrascrivere il file specificato, se esistente

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

-InputObject

Segreto di cui eseguire il backup, inviato tramite pipeline dall'output di una chiamata di recupero.

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

-Name

Nome segreto. Il cmdlet costruisce il nome FQDN di un segreto dal nome dell'insieme di credenziali, l'ambiente e il nome del segreto attualmente selezionati.

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

-OutputFile

File di output. File di output per archiviare il backup del certificato. Se non specificato, verrà generato un nome file predefinito.

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

-VaultName

Nome dell'insieme di credenziali. Il cmdlet costruisce il nome di dominio completo di un insieme di credenziali in base al nome e all'ambiente attualmente selezionato.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

PSKeyVaultCertificateIdentityItem

Output

String