New-AzWebAppSSLBinding

  • Referentie
Module:
Az.Websites

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

Syntax

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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePassword

Hiermee geeft u het ontsleutelingswachtwoord voor het certificaat op.

Type:String
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de web-app.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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]
Accepted values:Disabled, SniEnabled, IpBasedEnabled
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Thumbprint

Hiermee geeft u de unieke id voor het certificaat.

Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSSite

Uitvoerwaarden

HostNameSslState