New-AzWebAppSSLBinding
Azure Web App에 대한 SSL 인증서 바인딩을 만듭니다.
구문
S1
New-AzWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
S2
New-AzWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
S3
New-AzWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
S4
New-AzWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-AzWebAppSSLBinding cmdlet은 Azure Web App에 대한 SSL(Secure Socket Layer) 인증서 바인딩을 만듭니다.
이 cmdlet은 다음 두 가지 방법으로 SSL 바인딩을 만듭니다.
기존 인증서에 웹앱을 바인딩할 수 있습니다.
새 인증서를 업로드한 다음 웹앱을 이 새 인증서에 바인딩할 수 있습니다.
어떤 방법을 사용하든 인증서와 웹앱은 동일한 Azure 리소스 그룹과 연결되어야 합니다.
리소스 그룹 A에 웹앱이 있고 해당 웹앱을 리소스 그룹 B의 인증서에 바인딩하려는 경우 이 작업을 수행하는 유일한 방법은 인증서 복사본을 리소스 그룹 A에 업로드하는 것입니다. 새 인증서를 업로드하는 경우 Azure SSL 인증서에 대한 다음 요구 사항에 유의하세요.
인증서에는 프라이빗 키가 포함되어야 합니다.
인증서는 PFX(개인 정보 교환) 형식을 사용해야 합니다.
인증서의 주체 이름은 웹앱에 액세스하는 데 사용되는 도메인과 일치해야 합니다.
인증서는 최소 2048비트 암호화를 사용해야 합니다.
예제
예제 1: 웹앱에 인증서 바인딩
New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"
이 명령은 기존 Azure 인증서(지문 E3A38EBA60CAA1C162785A2E1C44A15AD450199C3 있는 인증서)를 ContosoWebApp이라는 웹앱에 바인딩합니다.
예제 2
Azure Web App에 대한 SSL 인증서 바인딩을 만듭니다. (autogenerated)
New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'
powershell
예제 3
Azure Web App에 대한 SSL 인증서 바인딩을 만듭니다. (autogenerated)
New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'
매개 변수
-CertificateFilePath
업로드할 인증서의 파일 경로를 지정합니다.
CertificateFilePath 매개 변수는 인증서가 아직 Azure에 업로드되지 않은 경우에만 필요합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
S1
Position: 4
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
S3
Position: 4
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-CertificatePassword
인증서의 암호 해독 암호를 지정합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
S1
Position: 5
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
S3
Position: 5
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-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
-Name
웹앱의 이름을 지정합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: 3
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ResourceGroupName
인증서가 할당된 리소스 그룹의 이름을 지정합니다.
동일한 명령에서는 ResourceGroupName 매개 변수와 WebApp 매개 변수를 사용할 수 없습니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
S1
Position: 0
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
S2
Position: 0
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Slot
웹앱 배포 슬롯의 이름을 지정합니다.
Get-AzWebAppSlot cmdlet을 사용하여 슬롯을 가져올 수 있습니다.
배포 슬롯은 인터넷을 통해 해당 앱에 액세스할 수 없도록 웹앱을 스테이징하고 유효성을 검사하는 방법을 제공합니다.
일반적으로 스테이징 사이트에 변경 내용을 배포하고, 변경 내용의 유효성을 검사한 다음, 프로덕션(인터넷에 액세스할 수 있는) 사이트에 배포합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
S1
Position: 2
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
S2
Position: 2
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-SslState
인증서를 사용할 수 있는지 여부를 지정합니다.
SSLState 매개 변수를 1로 설정하여 인증서를 사용하도록 설정하거나 SSLState 를 0으로 설정하여 인증서를 사용하지 않도록 설정합니다.
매개 변수 속성
형식: Nullable<T> [ Microsoft.Azure.Management.WebSites.Models.SslState ]
Default value: None
허용되는 값: Disabled, SniEnabled, IpBasedEnabled
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: 4
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Thumbprint
인증서의 고유 식별자를 지정합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
S2
Position: 6
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
S4
Position: 6
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-WebApp
웹앱을 지정합니다.
웹앱을 얻으려면 Get-AzWebApp cmdlet을 사용합니다.
ResourceGroupName 매개 변수 및/또는 WebAppName 과 동일한 명령에서 WebApp 매개 변수를 사용할 수 없습니다.
매개 변수 속성
형식: PSSite
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
S3
Position: 0
필수: True
파이프라인의 값: True
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
S4
Position: 0
필수: True
파이프라인의 값: True
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-WebAppName
새 SSL 바인딩을 만들 웹앱의 이름을 지정합니다.
동일한 명령에서 WebAppName 매개 변수와 WebApp 매개 변수를 사용할 수 없습니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
S1
Position: 1
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
S2
Position: 1
필수: 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 를 참조하세요.
출력
Microsoft.Azure.Management.WebSites.Models.HostNameSslState