Freigeben über


New-AzWebAppSSLBinding

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 der Domäne übereinstimmen, die 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.

Typ:String
Position:4
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CertificatePassword

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

Typ:String
Position:5
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der Web App an.

Typ:String
Position:3
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Nullable<T>[SslState]
Zulässige Werte:Disabled, SniEnabled, IpBasedEnabled
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Thumbprint

Gibt den eindeutigen Bezeichner für das Zertifikat an.

Typ:String
Position:6
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:PSSite
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSSite

Ausgaben

HostNameSslState