Backup-AzKeyVaultSecret
Esegue il backup di un segreto in un insieme di credenziali delle chiavi.
Sintassi
Backup-AzKeyVaultSecret
[-VaultName] <String>
[-Name] <String>
[[-OutputFile] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Backup-AzKeyVaultSecret
[-InputObject] <PSKeyVaultSecretIdentityItem>
[[-OutputFile] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet Backup-AzKeyVaultSecret esegue il backup di un segreto specificato in un insieme di credenziali delle chiavi scaricandolo e archiviandolo in un file. Se sono presenti più versioni del segreto, tutte le versioni vengono incluse nel backup. Poiché il contenuto scaricato è crittografato, non può essere usato all'esterno di Azure Key Vault. È possibile ripristinare un segreto sottoposto a backup in qualsiasi insieme di credenziali delle chiavi nella sottoscrizione da cui è stato eseguito il backup. I motivi tipici per usare questo cmdlet sono:
- Si vuole depositare una copia del segreto, in modo da avere una copia offline nel caso in cui si elimini accidentalmente il segreto nell'insieme di credenziali delle chiavi.
- È stato aggiunto un segreto a un insieme di credenziali delle chiavi e ora si vuole clonare il segreto in un'area di Azure diversa, in modo da poterlo usare da tutte le istanze dell'applicazione distribuita. Usare il cmdlet Backup-AzKeyVaultSecret per recuperare il segreto in formato crittografato e quindi usare il cmdlet Restore-AzKeyVaultSecret e specificare un insieme di credenziali delle chiavi nella seconda area. Si noti che le aree devono appartenere alla stessa area geografica.
Esempio
Esempio 1: Eseguire il backup di un segreto con un nome file generato automaticamente
Backup-AzKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret'
C:\Users\username\mykeyvault-mysecret-1527029447.01191Questo comando recupera il segreto denominato MySecret dall'insieme di credenziali delle chiavi denominato MyKeyVault e salva un backup del segreto in un file denominato automaticamente e visualizza il nome del file.
Esempio 2: Eseguire il backup di un segreto in un nome file specificato, sovrascrivendo il file esistente senza chiedere conferma
Backup-AzKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret' -OutputFile 'C:\Backup.blob' -Force
C:\Backup.blobQuesto comando recupera il segreto denominato MySecret dall'insieme di credenziali delle chiavi denominato MyKeyVault e salva un backup del segreto in un file denominato Backup.blob.
Esempio 3: Eseguire il backup di un segreto recuperato in precedenza in un nome file specificato
$secret = Get-AzKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret'
Backup-AzKeyVaultSecret -Secret $secret -OutputFile 'C:\Backup.blob'
C:\Backup.blobQuesto comando usa il nome e il nome dell'insieme di credenziali dell'oggetto $secret per recuperare il segreto e salvare il backup in un file denominato Backup.blob.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Richiede conferma prima di sovrascrivere il file di output, se presente.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 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: | PSKeyVaultSecretIdentityItem |
| Aliases: | Secret |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Specifica il nome del segreto di cui eseguire il backup.
| Type: | String |
| Aliases: | SecretName |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OutputFile
Specifica il file di output in cui è archiviato il BLOB di backup. Se non si specifica questo parametro, questo cmdlet genera automaticamente un nome file. Se si specifica il nome di un file di output esistente, l'operazione non verrà completata e restituirà un messaggio di errore che indica che il file di backup esiste già.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultName
Specifica il nome dell'insieme di credenziali delle chiavi che contiene il segreto di cui eseguire il backup.
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |