New-AzWebAppSSLBinding

  • Referenz
Modul:
Az.Websites

Erstellt eine SSL-Zertifikatbindung für eine 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>]

Beschreibung

Das Cmdlet New-AzWebAppSSLBinding erstellt eine SSL-Zertifikatbindung (Secure Socket Layer) für eine Azure Web App. Das Cmdlet erstellt eine SSL-Bindung auf zwei Arten:

  • Sie können eine Web App an ein vorhandenes Zertifikat binden.
  • Sie können ein neues Zertifikat hochladen und dann die Web App an dieses neue Zertifikat binden. Unabhängig davon, welcher Ansatz Sie verwenden, muss das Zertifikat und die Web App derselben Azure-Ressourcengruppe zugeordnet sein. Wenn Sie über eine Web App in Der Ressourcengruppe A verfügen und diese Web App an ein Zertifikat in Der Ressourcengruppe B binden möchten, besteht die einzige Möglichkeit darin, eine Kopie des Zertifikats in Die Ressourcengruppe A hochzuladen. Wenn Sie ein neues Zertifikat hochladen, beachten Sie die folgenden Anforderungen für ein Azure SSL-Zertifikat:
  • Das Zertifikat muss einen privaten Schlüssel enthalten.
  • Das Zertifikat muss das PFX-Format (Personal Information Exchange) verwenden.
  • Der Antragstellername des Zertifikats muss mit dem Vorgang übereinstimmen Standard, der für den Zugriff auf die Web App verwendet wird.
  • Das Zertifikat muss mindestens eine 2048-Bit-Verschlüsselung haben.

Beispiele

Beispiel 1: Binden eines Zertifikats an eine Web App

New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"

Dieser Befehl bindet ein vorhandenes Azure-Zertifikat (ein Zertifikat mit dem Fingerabdruck E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) an die Web-App mit dem Namen ContosoWebApp.

Beispiel 2

Erstellt eine SSL-Zertifikatbindung für eine Azure Web App. (automatisch generiert)

New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'

powershell

Beispiel 3

Erstellt eine SSL-Zertifikatbindung für eine Azure Web App. (automatisch generiert)

New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'

Parameter

-CertificateFilePath

Gibt den Dateipfad für das hochzuladende Zertifikat an. Der Parameter "CertificateFilePath " ist nur erforderlich, wenn das Zertifikat noch nicht in Azure hochgeladen wurde.

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

-CertificatePassword

Gibt das Entschlüsselungskennwort für das Zertifikat an.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-Name

Gibt den Namen der Web App an.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, der das Zertifikat zugewiesen ist. Sie können den Parameter ResourceGroupName und den WebApp-Parameter nicht im selben Befehl verwenden.

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

-Slot

Gibt den Namen des Web App-Bereitstellungsplatzes an. Sie können das Cmdlet Get-AzWebAppSlot verwenden, um einen Steckplatz abzurufen. Bereitstellungsplätze bieten ihnen die Möglichkeit, Web-Apps bereitzustellen und zu überprüfen, ohne dass diese Apps über das Internet zugänglich sind. In der Regel stellen Sie Ihre Änderungen auf einer Stagingwebsite bereit, überprüfen diese Änderungen und stellen sie dann auf der Produktionswebsite (internetzugriffsgeschützt) bereit.

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

-SslState

Gibt an, ob das Zertifikat aktiviert ist. Legen Sie den SSLState-Parameter auf 1 fest, um das Zertifikat zu aktivieren, oder legen Sie SSLState auf 0 fest, um das Zertifikat zu deaktivieren.

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

Gibt den eindeutigen Bezeichner für das Zertifikat an.

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

-WebApp

Gibt eine Web-App an. Verwenden Sie das Cmdlet "Get-AzWebApp", um eine Web App abzurufen. Sie können den WebApp-Parameter nicht im selben Befehl wie der Parameter "ResourceGroupName " und/oder " WebAppName" verwenden.

Type:PSSite
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WebAppName

Gibt den Namen der Web App an, für die die neue SSL-Bindung erstellt wird. Sie können den WebAppName-Parameter und den WebApp-Parameter nicht im selben Befehl verwenden.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

PSSite

Ausgaben

HostNameSslState