Freigeben über

New-AzWebAppSSLBinding

Modul:
Az.Websites Module

Erstellt eine SSL-Zertifikatbindung für eine Azure Web App.

Syntax

S1 

New-AzWebAppSSLBinding
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    [[-Slot] <String>]
    [-Name] <String>
    [[-SslState] <SslState>]
    [-CertificateFilePath] <String>
    [-CertificatePassword] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S2 

New-AzWebAppSSLBinding
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    [[-Slot] <String>]
    [-Name] <String>
    [[-SslState] <SslState>]
    [-Thumbprint] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S3 

New-AzWebAppSSLBinding
    [-WebApp] <PSSite>
    [-Name] <String>
    [[-SslState] <SslState>]
    [-CertificateFilePath] <String>
    [-CertificatePassword] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S4 

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 Format für persönliche Informationen Exchange (PFX) 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 2048-Bit-Verschlüsselung verwenden.

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. (autogenerated)

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. (autogenerated)

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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S1
Position:4
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
S3
Position:4
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CertificatePassword

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S1
Position:5
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
S3
Position:5
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen der Web App an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S1
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
S2
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S1
Position:2
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
S2
Position:2
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Microsoft.Azure.Management.WebSites.Models.SslState]

Standardwert:None
Zulässige Werte:Disabled, SniEnabled, IpBasedEnabled
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:4
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Thumbprint

Gibt den eindeutigen Bezeichner für das Zertifikat an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S2
Position:6
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
S4
Position:6
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WebApp

Gibt eine Web-App an. Verwenden Sie zum Abrufen einer Web App das cmdlet Get-AzWebApp. Sie können den WebApp-Parameter nicht im selben Befehl wie der Parameter "ResourceGroupName " und/oder " WebAppName" verwenden.

Parametereigenschaften

Typ:PSSite
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S3
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
S4
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S1
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
S2
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSSite

Ausgaben

Microsoft.Azure.Management.WebSites.Models.HostNameSslState