你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Restore-AzKeyVaultSecret

从备份的机密在密钥保管库中创建机密。

语法

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

说明

Restore-AzKeyVaultSecret cmdlet 在指定的密钥保管库中创建机密。 此机密是输入文件中备份的机密的副本,其名称与原始机密相同。 如果密钥保管库已有同名机密,则此 cmdlet 将失败,而不是覆盖原始机密。 如果备份包含多个版本的机密,则还原所有版本。 将机密还原到的密钥保管库可以不同于备份机密的密钥保管库。 但是,密钥保管库必须使用同一订阅,并且位于同一地理位置(例如北美)的 Azure 区域中。 有关 Azure 区域到地理位置的映射,请参阅 Microsoft Azure 信任中心(https://azure.microsoft.com/support/trust-center/)。

示例

示例 1:还原备份的机密

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         :

此命令将机密(包括其所有版本)从名为 Backup.blob 的备份文件还原到名为 contoso 的密钥保管库中。

示例 2:还原备份的机密(使用 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         :

此命令将机密(包括其所有版本)从名为 Backup.blob 的备份文件还原到名为 contoso 的密钥保管库中。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Id

KeyVault 机密的 URI。 请确保它遵循以下格式:https://<vault-name>.vault.azure.net/secrets/<secret-name>/<version>

类型:String
别名:SecretId
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-InputFile

指定包含要还原的机密备份的输入文件。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-InputObject

KeyVault 对象

类型:PSKeyVault
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ParentResourceId

KeyVault 资源 ID

类型:String
别名:ResourceId
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-VaultName

指定要在其中还原机密的密钥保管库的名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

PSKeyVault

String

输出

PSKeyVaultSecret