New-AzureRmWebAppSSLBinding
Azure Web App에 대한 SSL 인증서 바인딩을 만듭니다.
Warning
AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.
AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.
구문
New-AzureRmWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
New-AzureRmWebAppSSLBinding cmdlet은 Azure Web App에 대한 SSL(Secure Socket Layer) 인증서 바인딩을 만듭니다. 이 cmdlet은 다음 두 가지 방법으로 SSL 바인딩을 만듭니다.
- 기존 인증서에 웹앱을 바인딩할 수 있습니다.
- 새 인증서를 업로드한 다음 웹앱을 이 새 인증서에 바인딩할 수 있습니다. 어떤 방법을 사용하든 인증서와 웹앱은 동일한 Azure 리소스 그룹과 연결되어야 합니다. 리소스 그룹 A에 웹앱이 있고 해당 웹앱을 리소스 그룹 B의 인증서에 바인딩하려는 경우 이 작업을 수행하는 유일한 방법은 인증서 복사본을 리소스 그룹 A에 업로드하는 것입니다. 새 인증서를 업로드하는 경우 Azure SSL 인증서에 대한 다음 요구 사항에 유의하세요.
- 인증서에 프라이빗 키가 포함되어 있어야 합니다.
- 인증서는 PFX(개인 정보 교환) 형식을 사용해야 합니다.
- 인증서의 주체 이름은 웹앱에 액세스하는 데 사용되는 도메인과 일치해야 합니다.
- 인증서는 최소한 2048비트 암호화를 사용해야 합니다.
예제
예제 1: 웹앱에 인증서 바인딩
PS C:\>New-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"
이 명령은 기존 Azure 인증서(지문 E3A38EBA60CAA1C162785A2E1C44A15AD450199C3 있는 인증서)를 ContosoWebApp이라는 웹앱에 바인딩합니다.
매개 변수
-CertificateFilePath
업로드할 인증서의 파일 경로를 지정합니다. CertificateFilePath 매개 변수는 인증서가 아직 Azure에 업로드되지 않은 경우에만 필요합니다.
형식: | String |
Position: | 4 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-CertificatePassword
인증서의 암호 해독 암호를 지정합니다.
형식: | String |
Position: | 5 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
형식: | IAzureContextContainer |
별칭: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Name
웹앱의 이름을 지정합니다.
형식: | String |
Position: | 3 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ResourceGroupName
인증서가 할당된 리소스 그룹의 이름을 지정합니다. 동일한 명령에서는 ResourceGroupName 매개 변수와 WebApp 매개 변수를 사용할 수 없습니다.
형식: | String |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Slot
웹앱 배포 슬롯의 이름을 지정합니다. Get-AzureRMWebAppSlot cmdlet을 사용하여 슬롯을 가져올 수 있습니다. 배포 슬롯은 인터넷을 통해 해당 앱에 액세스할 수 없도록 웹앱을 스테이징하고 유효성을 검사하는 방법을 제공합니다. 일반적으로 스테이징 사이트에 변경 내용을 배포하고, 변경 내용의 유효성을 검사한 다음, 프로덕션(인터넷에 액세스할 수 있는) 사이트에 배포합니다.
형식: | String |
Position: | 2 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SslState
인증서를 사용할 수 있는지 여부를 지정합니다. SSLState 매개 변수를 1로 설정하여 인증서를 사용하도록 설정하거나 SSLState를 0으로 설정하여 인증서를 사용하지 않도록 설정합니다.
형식: | Nullable<T>[SslState] |
허용되는 값: | Disabled, SniEnabled, IpBasedEnabled |
Position: | 4 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Thumbprint
인증서의 고유 식별자를 지정합니다.
형식: | String |
Position: | 6 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WebApp
웹앱을 지정합니다. 웹앱을 얻으려면 Get-AzureRmWebApp cmdlet을 사용합니다. ResourceGroupName 매개 변수 및/또는 WebAppName과 동일한 명령에서 WebApp 매개 변수를 사용할 수 없습니다.
형식: | PSSite |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-WebAppName
새 SSL 바인딩을 만들 웹앱의 이름을 지정합니다. 동일한 명령에서 WebAppName 매개 변수와 WebApp 매개 변수를 사용할 수 없습니다.
형식: | String |
Position: | 1 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
매개 변수: WebApp(ByValue)