Condividi tramite

Restore-AzKeyVaultSecret

  • Riferimento
Modulo:
Az.KeyVault

Crea un segreto in un insieme di credenziali delle chiavi da un segreto sottoposto a backup.

Sintassi

Restore-AzKeyVaultSecret
       [-VaultName] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultSecret
       [-Id] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultSecret
       [-InputObject] <PSKeyVault>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultSecret
       [-ParentResourceId] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Descrizione

Il cmdlet Restore-AzKeyVaultSecret crea un segreto nell'insieme di credenziali delle chiavi specificato. Questo segreto è una replica del segreto sottoposto a backup nel file di input e ha lo stesso nome del segreto originale. Se l'insieme di credenziali delle chiavi ha già un segreto con lo stesso nome, questo cmdlet non riesce anziché sovrascrivere il segreto originale. Se il backup contiene più versioni di un segreto, vengono ripristinate tutte le versioni. L'insieme di credenziali delle chiavi in cui si ripristina il segreto può essere diverso dall'insieme di credenziali delle chiavi da cui è stato eseguito il backup del segreto. Tuttavia, l'insieme di credenziali delle chiavi deve usare la stessa sottoscrizione e trovarsi in un'area di Azure nella stessa area geografica( ad esempio, America del Nord). Vedere il Centro protezione di Microsoft Azure (https://azure.microsoft.com/support/trust-center/) per il mapping delle aree di Azure alle aree geografiche.

Esempio

Esempio 1: Ripristinare un segreto di backup

Restore-AzKeyVaultSecret -VaultName 'contoso' -InputFile "C:\Backup.blob"

Vault Name   : contoso
Name         : secret1
Version      : 7128133570f84a71b48d7d0550deb74c
Id           : https://contoso.vault.azure.net:443/secrets/secret1/7128133570f84a71b48d7d0550deb74c
Enabled      : True
Expires      : 4/6/2018 3:59:43 PM
Not Before   :
Created      : 4/5/2018 11:46:28 PM
Updated      : 4/6/2018 11:30:17 PM
Content Type :
Tags         :

Questo comando ripristina un segreto, incluse tutte le relative versioni, dal file di backup denominato Backup.blob all'insieme di credenziali delle chiavi denominato contoso.

Esempio 2: Ripristinare un segreto sottoposto a backup (usando URI)

Restore-AzKeyVaultSecret -Id "https://contoso.vault.azure.net:443/secrets/" -InputFile "C:\Backup.blob"

Vault Name   : contoso
Name         : secret1
Version      : 7128133570f84a71b48d7d0550deb74c
Id           : https://contoso.vault.azure.net:443/secrets/secret1/7128133570f84a71b48d7d0550deb74c
Enabled      : True
Expires      : 4/6/2018 3:59:43 PM
Not Before   :
Created      : 4/5/2018 11:46:28 PM
Updated      : 4/6/2018 11:30:17 PM
Content Type :
Tags         :

Questo comando ripristina un segreto, incluse tutte le relative versioni, dal file di backup denominato Backup.blob all'insieme di credenziali delle chiavi denominato contoso.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

URI del segreto keyvault. Assicurarsi che il formato sia il seguente: https://<vault-name>.vault.azure.net/secrets/<secret-name>/<version>

Tipo:String
Alias:SecretId
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputFile

Specifica il file di input che contiene il backup del segreto da ripristinare.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Oggetto KeyVault

Tipo:PSKeyVault
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ParentResourceId

ID risorsa KeyVault

Tipo:String
Alias:ResourceId
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VaultName

Specifica il nome dell'insieme di credenziali delle chiavi in cui ripristinare il segreto.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSKeyVault

String

Output

PSKeyVaultSecret