Backup-AzKeyVaultCertificate

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

Syntax

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

Description

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

  • 如果您想要保留憑證的離線複本,以防您不小心從保存庫刪除原始複本。

  • 您已使用 金鑰保存庫 建立憑證,現在想要將物件複製到不同的 Azure 區域,以便從分散式應用程式的所有實例使用它。 使用Backup-AzKeyVaultCertificate Cmdlet 擷取加密格式的憑證,然後使用 Restore-AzKeyVaultCertificate Cmdlet,並在第二個區域中指定密鑰保存庫。

範例

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

Backup-AzKeyVaultCertificate -VaultName 'mykeyvault' -Name 'mycert'

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

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

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

Backup-AzKeyVaultCertificate -VaultName 'MyKeyVault' -Name 'MyCert' -OutputFile 'C:\Backup.blob'

C:\Backup.blob

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

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

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

C:\Backup.blob

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

參數

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:PSKeyVaultCertificateIdentityItem
Aliases:Certificate
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:SecretName
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OutputFile

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

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

PSKeyVaultCertificateIdentityItem

輸出

String