다음을 통해 공유


Backup-AzKeyVaultCertificate

키 자격 증명 모음에 인증서를 백업합니다.

구문

ByCertificateName (기본값)

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

ByCertificate

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

Description

Backup-AzKeyVaultCertificate cmdlet은 키 자격 증명 모음에서 지정된 인증서를 다운로드하고 파일에 저장하여 백업합니다. 인증서에 여러 버전이 있는 경우 모든 해당 버전이 백업에 포함됩니다. 다운로드한 콘텐츠는 암호화되므로 Azure Key Vault 외부에서 사용할 수 없습니다. 자격 증명 모음이 동일한 Azure 지역에 있는 한 백업된 인증서를 백업된 구독의 모든 키 자격 증명 모음으로 복원할 수 있습니다. 이 cmdlet을 사용하는 일반적인 이유는 다음과 같습니다.

  • 자격 증명 모음에서 원본을 실수로 삭제하는 경우 인증서의 오프라인 복사본을 유지하려고 합니다.

  • Key Vault 사용하여 인증서를 만들었으며 이제 분산 애플리케이션의 모든 인스턴스에서 사용할 수 있도록 개체를 다른 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 자격 증명 모음의 이름입니다. Backup.blob이라는 파일에 대한 VaultName이며 파일이 이미 있는 경우 자동으로 덮어씁니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DefaultProfile

Azure 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Force

지정된 파일이 있는 경우 덮어씁니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InputObject

백업할 비밀로, 검색 호출의 출력에서 파이프라인됩니다.

매개 변수 속성

형식:PSKeyVaultCertificateIdentityItem
Default value:None
와일드카드 지원:False
DontShow:False
별칭:인증서

매개 변수 집합

ByCertificate
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

비밀 이름. Cmdlet은 자격 증명 모음 이름, 현재 선택된 환경 및 비밀 이름에서 비밀의 FQDN을 생성합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:SecretName

매개 변수 집합

ByCertificateName
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-OutputFile

출력 파일입니다. 인증서의 백업을 저장할 출력 파일입니다. 지정하지 않으면 기본 파일 이름이 생성됩니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:2
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-VaultName

자격 증명 모음 이름입니다. Cmdlet은 이름 및 현재 선택된 환경에 따라 자격 증명 모음의 FQDN을 생성합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ByCertificateName
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSKeyVaultCertificateIdentityItem

출력

String