共用方式為

Backup-AzKeyVaultSecret

  • 參考
模組:
Az.KeyVault

備份金鑰保存庫中的秘密。

語法

Backup-AzKeyVaultSecret
      [-VaultName] <String>
      [-Name] <String>
      [[-OutputFile] <String>]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Backup-AzKeyVaultSecret
      [-InputObject] <PSKeyVaultSecretIdentityItem>
      [[-OutputFile] <String>]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Backup-AzKeyVaultSecret Cmdlet 會藉由下載密鑰保存庫並將它儲存在檔案中，來備份密鑰保存庫中的指定秘密。 如果有多個版本的秘密，所有版本都會包含在備份中。 由於下載的內容已加密，因此無法在 Azure 金鑰保存庫 外部使用。 您可以將備份的秘密還原至其備份的來源訂用帳戶中的任何密鑰保存庫。 使用此 Cmdlet 的一般原因包括：

  • 您想要委付密碼的複本，以便在不小心刪除密鑰保存庫中的秘密時，擁有脫機複本。
  • 您已將秘密新增至金鑰保存庫，現在想要將秘密複製到不同的 Azure 區域，以便從分散式應用程式的所有實例使用它。 使用Backup-AzKeyVaultSecret Cmdlet 擷取加密格式的秘密，然後使用 Restore-AzKeyVaultSecret Cmdlet，並在第二個區域中指定密鑰保存庫。 （請注意，區域必須屬於相同的地理位置。

範例

範例 1：使用自動產生的檔名備份秘密

Backup-AzKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret'

C:\Users\username\mykeyvault-mysecret-1527029447.01191

此命令會從名為 MyKeyVault 的金鑰保存庫擷取名為 MySecret 的秘密，並將該秘密的備份儲存至自動為您命名的檔案，並顯示檔名。

範例 2：將秘密備份至指定的檔名，而不提示，覆寫現有的檔案

Backup-AzKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret' -OutputFile 'C:\Backup.blob' -Force

C:\Backup.blob

此命令會從名為 MyKeyVault 的金鑰保存庫擷取名為 MySecret 的秘密，並將該秘密的備份儲存至名為 Backup.blob 的檔案。

範例 3：備份先前擷取到指定檔名的秘密

$secret = Get-AzKeyVaultSecret -VaultName 'MyKeyVault' -Name 'MySecret'
Backup-AzKeyVaultSecret -Secret $secret -OutputFile 'C:\Backup.blob'

C:\Backup.blob

此命令會使用$secret物件的保存庫名稱和名稱來擷取秘密，並將其備份儲存至名為Backup.blob的檔案。

參數

-Confirm

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

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

-DefaultProfile

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

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

-Force

如果存在，請先提示您進行確認，然後再覆寫輸出檔案。

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

-InputObject

要備份的秘密，從擷取呼叫的輸出中管線。

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

-Name

指定要備份的秘密名稱。

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

-OutputFile

指定備份 Blob 儲存所在的輸出檔案。 如果您未指定此參數，此 Cmdlet 會為您產生檔名。 如果您指定現有輸出檔的名稱，作業將不會完成，並傳回備份檔已經存在的錯誤訊息。

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

-VaultName

指定要備份之秘密的金鑰保存庫名稱。

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

-WhatIf

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

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

輸入

PSKeyVaultSecretIdentityItem

輸出

String