New-AzWebAppSSLBinding
Hiermee maakt u een SSL-certificaatbinding voor een Azure-web-app.
Syntaxis
New-AzWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Met de cmdlet New-AzWebAppSSLBinding maakt u een SSL-certificaatbinding (Secure Socket Layer) voor een Azure-web-app. De cmdlet maakt op twee manieren een SSL-binding:
- U kunt een web-app verbinden met een bestaand certificaat.
- U kunt een nieuw certificaat uploaden en de web-app vervolgens verbinden met dit nieuwe certificaat. Ongeacht welke benadering u gebruikt, moeten het certificaat en de web-app worden gekoppeld aan dezelfde Azure-resourcegroep. Als u een web-app in resourcegroep A hebt en u die web-app wilt binden aan een certificaat in resourcegroep B, kunt u dit alleen doen door een kopie van het certificaat te uploaden naar resourcegroep A. Als u een nieuw certificaat uploadt, moet u rekening houden met de volgende vereisten voor een Azure SSL-certificaat:
- Het certificaat moet een persoonlijke sleutel bevatten.
- Het certificaat moet de PFX-indeling (Personal Information Exchange) gebruiken.
- De onderwerpnaam van het certificaat moet overeenkomen met het domein dat wordt gebruikt voor toegang tot de web-app.
- Het certificaat moet minimaal 2048-bits versleuteling gebruiken.
Voorbeelden
Voorbeeld 1: Een certificaat binden aan een web-app
New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"Met deze opdracht wordt een bestaand Azure-certificaat (een certificaat met de vingerafdruk E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) gekoppeld aan de web-app met de naam ContosoWebApp.
Voorbeeld 2
Hiermee maakt u een SSL-certificaatbinding voor een Azure-web-app. (automatisch gegenereerd)
New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'powershell
Voorbeeld 3
Hiermee maakt u een SSL-certificaatbinding voor een Azure-web-app. (automatisch gegenereerd)
New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'Parameters
-CertificateFilePath
Hiermee geeft u het bestandspad op voor het certificaat dat moet worden geüpload. De parameter CertificateFilePath is alleen vereist als het certificaat nog niet is geüpload naar Azure.
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-CertificatePassword
Hiermee geeft u het ontsleutelingswachtwoord voor het certificaat op.
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
| Type: | SwitchParameter |
| Aliassen: | cf |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.
| Type: | IAzureContextContainer |
| Aliassen: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Name
Hiermee geeft u de naam van de web-app.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ResourceGroupName
Hiermee geeft u de naam op van de resourcegroep waaraan het certificaat is toegewezen. U kunt de parameter ResourceGroupName en de parameter WebApp niet gebruiken in dezelfde opdracht.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Slot
Hiermee geeft u de naam van de web-app-implementatiesite. U kunt de cmdlet Get-AzWebAppSlot gebruiken om een site op te halen. Implementatiesites bieden een manier om web-apps te faseren en te valideren zonder dat deze apps toegankelijk zijn via internet. Normaal gesproken implementeert u uw wijzigingen op een faseringssite, valideert u deze wijzigingen en implementeert u deze vervolgens op de productiesite (toegankelijk via internet).
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-SslState
Hiermee geeft u op of het certificaat is ingeschakeld. Stel de PARAMETER SSLState in op 1 om het certificaat in te schakelen of stel SSLState in op 0 om het certificaat uit te schakelen.
| Type: | Nullable<T>[SslState] |
| Geaccepteerde waarden: | Disabled, SniEnabled, IpBasedEnabled |
| Position: | 4 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Thumbprint
Hiermee geeft u de unieke id voor het certificaat.
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-WebApp
Hiermee geeft u een web-app. Gebruik de cmdlet Get-AzWebApp om een web-app op te halen. U kunt de parameter WebApp niet gebruiken in dezelfde opdracht als de parameter ResourceGroupName en/of de WebAppName.
| Type: | PSSite |
| Position: | 0 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-WebAppName
Hiermee geeft u de naam op van de web-app waarvoor de nieuwe SSL-binding wordt gemaakt. U kunt de parameter WebAppName en de parameter WebApp niet gebruiken in dezelfde opdracht.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliassen: | wi |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |