Import-AzKeyVaultCertificate

참조

모듈:: Az.KeyVault

인증서를 키 자격 증명 모음으로 가져옵니다.

구문

Import-AzKeyVaultCertificate
      [-VaultName] <String>
      [-Name] <String>
      -FilePath <String>
      [-Password <SecureString>]
      [-PolicyPath <String>]
      [-PolicyObject <PSKeyVaultCertificatePolicy>]
      [-Tag <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Import-AzKeyVaultCertificate
      [-VaultName] <String>
      [-Name] <String>
      -CertificateString <String>
      [-ContentType <String>]
      [-Password <SecureString>]
      [-PolicyPath <String>]
      [-PolicyObject <PSKeyVaultCertificatePolicy>]
      [-Tag <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Import-AzKeyVaultCertificate
      [-VaultName] <String>
      [-Name] <String>
      [-PolicyPath <String>]
      [-PolicyObject <PSKeyVaultCertificatePolicy>]
      [-CertificateCollection] <X509Certificate2Collection>
      [-Tag <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Import-AzKeyVaultCertificate cmdlet은 인증서를 키 자격 증명 모음으로 가져옵니다. 다음 방법 중 하나를 사용하여 가져올 인증서를 만들 수 있습니다.

인증서 서명 요청을 만들고 인증 기관에 제출하는 데 사용합니다 Add-AzKeyVaultCertificate . https://learn.microsoft.com/azure/key-vault/certificates/create-certificate-signing-request를 참조하세요.
인증서와 프라이빗 키가 모두 포함된 .pfx 또는 .p12 파일과 같은 기존 인증서 패키지 파일을 사용합니다.

예제

예제 1: 키 자격 증명 모음 인증서 가져오기

$Password = ConvertTo-SecureString -String "****" -AsPlainText -Force
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -FilePath "C:\Users\contosoUser\Desktop\import.pfx" -Password $Password

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Thumbprint  : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Tags        :
Enabled     : True
Created     : 2/8/2016 11:50:43 PM
Updated     : 2/8/2016 11:50:43 PM

첫 번째 명령은 ConvertTo-SecureString cmdlet을 사용하여 보안 암호를 만든 다음 $Password 변수에 저장합니다. 두 번째 명령은 ImportCert01이라는 인증서를 CosotosoKV01 키 자격 증명 모음으로 가져옵니다.

예제 2: CertificateString을 통해 키 자격 증명 모음 인증서 가져오기

$Password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$Base64String = [System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes("import.pfx"))
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -CertificateString $Base64String -Password $Password

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Thumbprint  : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Tags        :
Enabled     : True
Created     : 2/8/2016 11:50:43 PM
Updated     : 2/8/2016 11:50:43 PM

첫 번째 명령은 ConvertTo-SecureString cmdlet을 사용하여 보안 암호를 만든 다음 $Password 변수에 저장합니다. 두 번째 명령은 인증서를 Base64로 인코딩된 표현으로 읽습니다. 세 번째 명령은 ImportCert01이라는 인증서를 CosotosoKV01 키 자격 증명 모음으로 가져옵니다.

예제 3: PolicyFile을 사용하여 키 자격 증명 모음 인증서 가져오기

$Password = ConvertTo-SecureString -String "****" -AsPlainText -Force
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -FilePath "C:\Users\contosoUser\Desktop\import.pfx" -Password $Password -PolicyPath "C:\Users\contosoUser\Desktop\policy.json"

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

KeyId         : https://ContosoKV01.vault.azure.net/keys/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
SecretId      : https://ContosoKV01.vault.azure.net/secrets/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Thumbprint    : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Policy        :
                Secret Content Type: application/x-pkcs12
                Issuer Name    : Unknown
                Created On     : 3/22/2023 6:00:52 AM
                Updated On     : 4/27/2023 9:52:53 AM
                ...
RecoveryLevel : Recoverable+Purgeable
Enabled       : True
Expires       : 6/9/2023 6:20:26 AM
NotBefore     : 3/11/2023 6:20:26 AM
Created       : 4/24/2023 9:05:51 AM
Updated       : 4/24/2023 9:05:51 AM
Tags          : {}
VaultName     : ContosoKV01
Name          : ImportCert01
Version       : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Id            : https://ContosoKV01.vault.azure.net/certificates/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

첫 번째 명령은 ConvertTo-SecureString cmdlet을 사용하여 보안 암호를 만든 다음 $Password 변수에 저장합니다. 두 번째 명령은 파일로 정의된 정책을 사용하여 ImportCert01이라는 인증서를 CosotosoKV01 키 자격 증명 모음으로 가져옵니다.

매개 변수

-CertificateCollection

키 자격 증명 모음에 추가할 인증서 컬렉션을 지정합니다.

형식:	X509Certificate2Collection
Position:	2
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-CertificateString

가져올 인증서 개체의 Base64로 인코딩된 표현입니다. 이 인증서는 프라이빗 키를 포함해야 합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

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

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContentType

가져올 인증서의 유형을 지정합니다. 인증서 문자열을 기본적으로 PFX 형식으로 간주합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FilePath

이 cmdlet에서 가져오는 인증서 파일의 경로를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

인증서 이름을 지정합니다. 이 cmdlet은 키 자격 증명 모음 이름, 현재 선택된 환경 및 인증서 이름에서 인증서의 FQDN(정규화된 도메인 이름)을 생성합니다.

형식:	String
별칭:	CertificateName
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Password

인증서 파일의 암호를 지정합니다.

형식:	SecureString
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PolicyObject

인증서에 대한 관리 정책을 지정하는 메모리 내 개체입니다. PolicyPath와 상호 배타적입니다.

형식:	PSKeyVaultCertificatePolicy
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-PolicyPath

JSON 인코딩된 정책 정의를 포함하는 인증서에 대한 관리 정책을 지정하는 파일 경로입니다. PolicyObject와 상호 배타적입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Tag

해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"}

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-VaultName

이 cmdlet이 인증서를 가져올 키 자격 증명 모음 이름을 지정합니다. 이 cmdlet은 이름 및 현재 선택된 환경에 따라 키 자격 증명 모음의 FQDN(정규화된 도메인 이름)을 생성합니다.

형식:	String
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String

X509Certificate2Collection

Hashtable

출력

PSKeyVaultCertificate

다음을 통해 공유

Import-AzKeyVaultCertificate

구문

Description

예제

예제 1: 키 자격 증명 모음 인증서 가져오기

예제 2: CertificateString을 통해 키 자격 증명 모음 인증서 가져오기

예제 3: PolicyFile을 사용하여 키 자격 증명 모음 인증서 가져오기

매개 변수

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

입력

출력

추가 리소스

다음을 통해 공유

Import-AzKeyVaultCertificate

구문

Description

예제

예제 1: 키 자격 증명 모음 인증서 가져오기

예제 2: CertificateString을 통해 키 자격 증명 모음 인증서 가져오기

예제 3: PolicyFile을 사용하여 키 자격 증명 모음 인증서 가져오기

매개 변수

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

입력

출력

관련 링크

추가 리소스