共用方式為


Restore-AzureKeyVaultKey

從備份的金鑰建立金鑰保存庫中的金鑰。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

Syntax

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

Description

Restore-AzureKeyVaultKey Cmdlet 會在指定的密鑰保存庫中建立密鑰。 此金鑰是輸入檔中備份金鑰的複本,且名稱與原始密鑰相同。 如果金鑰保存庫已有相同名稱的金鑰,此 Cmdlet 會失敗,而不是覆寫原始密鑰。 如果備份包含多個版本的金鑰,則會還原所有版本。 您還原金鑰的金鑰保存庫可能會與您備份金鑰的來源金鑰儲存庫不同。 不過,金鑰保存庫必須使用相同的訂用帳戶,且位於相同地理位置的 Azure 區域中(例如,北美洲)。 如需 Azure 區域與地理位置的對應,請參閱 Microsoft Azure 信任中心 (https://azure.microsoft.com/support/trust-center/)。

範例

範例 1:還原備份的金鑰

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

此命令會將金鑰,包括其所有版本,從名為Backup.blob的備份檔還原至名為 MyKeyVault 的金鑰保存庫。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
Aliases:cf
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

類型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

指定要還原之金鑰備份的輸入檔。

類型:String
Position:1
預設值:None
必要:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

KeyVault 物件

類型:PSKeyVault
Position:0
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

KeyVault 資源標識碼

類型:String
Position:0
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-VaultName

指定要還原金鑰的金鑰儲存庫名稱。

類型:String
Position:0
預設值:None
必要:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
Aliases:wi
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

PSKeyVault

參數:InputObject (ByValue)

String

輸出

PSKeyVaultKey