Add-AzureRmVpnClientRootCertificate
VPN 클라이언트 루트 인증서를 추가합니다.
Warning
AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.
AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.
구문
Add-AzureRmVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Add-AzureRmVpnClientRootCertificate cmdlet은 가상 네트워크 게이트웨이에 루트 인증서를 추가합니다. 루트 인증서는 루트 인증 기관을 식별하는 X.509 인증서입니다. 기본적으로 게이트웨이에 사용되는 모든 인증서는 루트 인증서를 신뢰합니다. 이 cmdlet은 기존 인증서를 게이트웨이 루트 인증서로 할당합니다. 사용할 수 있는 X.509 인증서가 없는 경우 공개 키 인프라를 통해 인증서를 생성하거나 makecert.exe 같은 인증서 생성기를 사용할 수 있습니다. 루트 인증서를 추가하려면 인증서 이름을 지정하고 인증서의 텍스트 전용 표현을 제공해야 합니다(자세한 내용은 PublicCertData 매개 변수 참조). Azure를 사용하면 게이트웨이에 둘 이상의 루트 인증서를 할당할 수 있습니다. 여러 루트 인증서는 여러 회사의 사용자를 포함하는 조직에서 배포하는 경우가 많습니다.
예제
예제 1: 가상 게이트웨이에 클라이언트 루트 인증서 추가
PS C:\>$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertficate.cer"
PS C:\> $CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
PS C:\> Add-AzureRmVpnClientRootCertificate -PublicCertData $CertificateText -ResourceGroupName "ContosoResourceGroup" -VirtualNetworkGatewayName "ContosoVirtualGateway" -VpnClientRootCertificateName "ContosoClientRootCertificate"이 예제에서는 ContosoVirtualGateway라는 가상 게이트웨이에 클라이언트 루트 인증서를 추가합니다. 첫 번째 명령은 Get-Content cmdlet을 사용하여 루트 인증서의 이전에 내보낸 텍스트 표현을 가져오고 해당 텍스트 데이터를 $Text 변수에 저장합니다. 그런 다음 두 번째 명령은 for 루프를 사용하여 첫 번째 줄과 마지막 줄을 제외한 모든 텍스트를 추출합니다. 추출된 텍스트는 $CertificateText 변수에 저장됩니다. 그런 다음 세 번째 명령은 Add-AzureRmVpnClientRootCertificate cmdlet과 함께 $CertificateText 저장된 텍스트를 사용하여 루트 인증서를 게이트웨이에 추가합니다.
매개 변수
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| 형식: | IAzureContextContainer |
| 별칭: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PublicCertData
추가할 루트 인증서의 텍스트 표현을 지정합니다.
텍스트 표현을 가져오려면 인증서를 .cer 형식(Base64 인코딩 사용)으로 내보낸 다음 결과 파일을 텍스트 편집기에서 엽니다.
이렇게 하면 다음과 유사한 출력이 표시됩니다(실제 출력에는 여기에 표시된 약식 샘플보다 더 많은 텍스트 줄이 포함됨): ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HgUNEW8343NMJ publicCertData는 파일의 첫 번째 줄(----- BEGIN CERTIFICATE ----- ----- -----)과 마지막 줄(----- END CERTIFICATE -----) 사이의 모든 줄로 구성됩니다.
다음과 유사한 Windows PowerShell 명령을 사용하여 이 데이터를 검색할 수 있습니다. $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertficate.cer"$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text\[$i\]}
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ResourceGroupName
루트 인증서가 할당된 리소스 그룹의 이름을 지정합니다. 리소스 그룹은 인벤토리 관리 및 일반 Azure 관리를 간소화하는 데 도움이 되는 항목을 분류합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-VirtualNetworkGatewayName
인증서가 추가되는 가상 네트워크 게이트웨이의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-VpnClientRootCertificateName
이 cmdlet이 추가하는 클라이언트 루트 인증서의 이름을 지정합니다.
| 형식: | String |
| 별칭: | ResourceName |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |