Backup-AzureKeyVaultCertificate

參考

模組:: AzureRM.KeyVault

備份金鑰保存庫中的憑證。

警告

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

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

語法

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

Backup-AzureKeyVaultCertificate
      [-InputObject] <PSKeyVaultCertificateIdentityItem>
      [[-OutputFile] <String>]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

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

如果您想要保留憑證的離線複本，以防您不小心從保存庫刪除原始複本。
您已使用金鑰保存庫建立憑證，現在想要將物件複製到不同的 Azure 區域，以便從分散式應用程式的所有實例使用它。 使用Backup-AzureKeyVaultCertificate Cmdlet 擷取加密格式的憑證，然後使用 Restore-AzureKeyVaultCertificate Cmdlet，並在第二個區域中指定密鑰保存庫。

範例

範例 1：使用自動產生的檔名備份憑證

PS C:\Users\username\> Backup-AzureKeyVaultCertificate -VaultName 'mykeyvault' -Name 'mycert'

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

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

範例 2：將憑證備份至指定的檔名

PS C:\> Backup-AzureKeyVaultKey -VaultName 'MyKeyVault' -Name 'MyCert' -OutputFile 'C:\Backup.blob'

C:\Backup.blob

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

範例 3：將先前擷取的憑證備份至指定的檔名，而不提示覆寫目的地檔案。

PS C:\> $cert = Get-AzureKeyVaultCertificate -VaultName 'MyKeyVault' -Name 'MyCert'
PS C:\> Backup-AzureKeyVaultCertificate -Certificate $cert -OutputFile 'C:\Backup.blob' -Force

C:\Backup.blob

此命令會建立名為 $cert 之憑證的備份。名為 $cert 的保存庫中的名稱。VaultName 至名為 Backup.blob 的檔案，如果檔案已經存在，則會以無訊息方式覆寫檔案。

參數

-Confirm

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

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

-DefaultProfile

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

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

-Force

如果存在，請覆寫指定的檔案

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

-InputObject

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

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

-Name

秘密名稱。 Cmdlet 會從保存庫名稱建構秘密的 FQDN，目前選取的環境和秘密名稱。

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

-OutputFile

輸出檔案。要儲存憑證備份的輸出檔案。如果未指定，則會產生預設檔名。

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

-VaultName

保存庫名稱。 Cmdlet 會根據名稱和目前選取的環境來建構保存庫的 FQDN。

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

-WhatIf

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

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

輸入

PSKeyVaultCertificateIdentityItem

參數：InputObject （ByValue）

輸出

String

共用方式為