Compartir a través de

Restore-AzureKeyVaultSecret

  • Referencia
Módulo:
AzureRM.KeyVault

Crea un secreto en un almacén de claves a partir de un secreto de copia de seguridad.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Restore-AzureKeyVaultSecret
       [-VaultName] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzureKeyVaultSecret
       [-InputObject] <PSKeyVault>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzureKeyVaultSecret
       [-ResourceId] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

El cmdlet Restore-AzureKeyVaultSecret crea un secreto en el almacén de claves especificado. Este secreto es una réplica del secreto de copia de seguridad en el archivo de entrada y tiene el mismo nombre que el secreto original. Si el almacén de claves ya tiene un secreto con el mismo nombre, este cmdlet produce un error en lugar de sobrescribir el secreto original. Si la copia de seguridad contiene varias versiones de un secreto, se restauran todas las versiones. El almacén de claves en el que se restaura el secreto puede ser diferente del almacén de claves del que ha creado una copia de seguridad del secreto. Sin embargo, el almacén de claves debe usar la misma suscripción y estar en una región de Azure en la misma geografía (por ejemplo, Norteamérica). Consulte el Centro de confianza de Microsoft Azure (https://azure.microsoft.com/support/trust-center/) para obtener la asignación de regiones de Azure a zonas geográficas.

Ejemplos

Ejemplo 1: Restaurar un secreto de copia de seguridad

PS C:\> Restore-AzureKeyVaultSecret -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         :

Este comando restaura un secreto, incluidas todas sus versiones, desde el archivo de copia de seguridad denominado Backup.blob en el almacén de claves denominado contoso.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputFile

Especifica el archivo de entrada que contiene la copia de seguridad del secreto que se va a restaurar.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

KeyVault (objeto)

Tipo:PSKeyVault
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceId

Id. de recurso de KeyVault

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VaultName

Especifica el nombre del almacén de claves en el que se va a restaurar el secreto.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSKeyVault

Parámetros: InputObject (ByValue)

String

Salidas

PSKeyVaultSecret