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 |