Restore-AzKeyVaultKey

Crea una chiave in un insieme di credenziali delle chiavi da una chiave di cui è stato eseguito il backup.

Sintassi

Restore-AzKeyVaultKey
       [-VaultName] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultKey
       -HsmName <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultKey
       [-InputObject] <PSKeyVault>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultKey
       [-HsmObject] <PSManagedHsm>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultKey
       [-ResourceId] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultKey
       -HsmResourceId <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Descrizione

Il cmdlet Restore-AzKeyVaultKey crea una chiave nell'insieme di credenziali delle chiavi specificato. Questa chiave è una replica della chiave di cui è stato eseguito il backup nel file di input e ha lo stesso nome della chiave originale. Se l'insieme di credenziali delle chiavi ha già una chiave con lo stesso nome, questo cmdlet ha esito negativo anziché sovrascrivere la chiave originale. Se il backup contiene più versioni di una chiave, vengono ripristinate tutte le versioni. L'insieme di credenziali delle chiavi in cui si ripristina la chiave può essere diverso dall'insieme di credenziali delle chiavi da cui è stato eseguito il backup della chiave. 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 una chiave di cui è stato eseguito il backup

Restore-AzKeyVaultKey -VaultName 'MyKeyVault' -InputFile "C:\Backup.blob"

Vault Name     : MyKeyVault
Name           : key1
Version        : 394f9379a47a4e2086585468de6c7ae5
Id             : https://mykeyvault.vault.azure.net:443/keys/key1/394f9379a47a4e2086585468de6c7ae5
Enabled        : True
Expires        :
Not Before     :
Created        : 4/6/2018 11:31:36 PM
Updated        : 4/6/2018 11:35:04 PM
Purge Disabled : False
Tags           :

Questo comando ripristina una chiave, incluse tutte le relative versioni, dal file di backup denominato Backup.blob all'insieme di credenziali delle chiavi denominato MyKeyVault.

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

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

-HsmName

Nome HSM. Il cmdlet costruisce il nome di dominio completo di un modulo di protezione hardware gestito in base al nome e all'ambiente attualmente selezionato.

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

-HsmObject

Oggetto HSM

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

-HsmResourceId

ID risorsa Hsm

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

-InputFile

Specifica il file di input che contiene il backup della chiave da ripristinare.

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

-InputObject

Oggetto KeyVault

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

-ResourceId

ID risorsa KeyVault

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

-VaultName

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

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

PSKeyVault

String

Output

PSKeyVaultKey