Delen via

New-AzureRmWebAppSSLBinding

  • Referentie
Module:
AzureRM.Websites

Hiermee maakt u een SSL-certificaatbinding voor een Azure-web-app.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

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

Met de cmdlet New-AzureRmWebAppSSLBinding 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

PS C:\>New-AzureRmWebAppSSLBinding -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.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen: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-AzureRMWebAppSlot 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-AzureRmWebApp 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

Invoerwaarden

Site

Parameters: WebApp (ByValue)

Uitvoerwaarden

HostNameSslState