共用方式為

Restore-AzureKeyVaultSecret

  • 參考
模組:
AzureRM.KeyVault

從備份的秘密，在密鑰保存庫中建立秘密。

警告

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

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

語法

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

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

範例

範例 1：還原備份的秘密

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         :

此命令會將秘密，包括其所有版本，從名為Backup.blob的備份檔還原到名為 contoso 的金鑰保存庫。

參數

-Confirm

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

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputFile

指定要還原之秘密備份的輸入檔。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-InputObject

KeyVault 物件

類型:PSKeyVault
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ResourceId

KeyVault 資源標識碼

類型:String
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

參數：InputObject （ByValue）

String

輸出

PSKeyVaultSecret