Share via

New-AzWebAppSSLBinding

  • Referencia
Modul:
Az.Websites

SSL-tanúsítványkötést hoz létre egy Azure-webalkalmazáshoz.

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

A New-AzWebAppSSLBinding parancsmag ssl-tanúsítványkötést hoz létre egy Azure-webalkalmazáshoz. A parancsmag kétféleképpen hoz létre SSL-kötést:

  • A webalkalmazásokat meglévő tanúsítványhoz kötheti.
  • Feltölthet egy új tanúsítványt, majd a webalkalmazást ehhez az új tanúsítványhoz kötheti. A használt megközelítéstől függetlenül a tanúsítványt és a webalkalmazást ugyanahhoz az Azure-erőforráscsoporthoz kell társítani. Ha van egy webalkalmazása az A erőforráscsoportban, és a webalkalmazást a B erőforráscsoport egyik tanúsítványához szeretné kötni, ennek egyetlen módja, ha feltölti a tanúsítvány egy példányát az A erőforráscsoportba. Ha új tanúsítványt tölt fel, tartsa szem előtt az Azure SSL-tanúsítványra vonatkozó alábbi követelményeket:
  • A tanúsítványnak tartalmaznia kell egy titkos kulcsot.
  • A tanúsítványnak a Személyes adatcsere (PFX) formátumot kell használnia.
  • A tanúsítvány tulajdonosának nevének meg kell egyeznie a webalkalmazás eléréséhez használt tartománnyal.
  • A tanúsítványnak legalább 2048 bites titkosítást kell használnia.

Példák

1. példa: Tanúsítvány kötése webalkalmazáshoz

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

Ez a parancs egy meglévő Azure-tanúsítványt (egy ujjlenyomattal rendelkező tanúsítványt E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) köt a ContosoWebApp nevű webalkalmazáshoz.

2. példa

SSL-tanúsítványkötést hoz létre egy Azure-webalkalmazáshoz. (automatikusan létrehozott)

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

powershell

3. példa

SSL-tanúsítványkötést hoz létre egy Azure-webalkalmazáshoz. (automatikusan létrehozott)

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

Paraméterek

-CertificateFilePath

Megadja a feltöltendő tanúsítvány fájlelérési útját. A CertificateFilePath paraméter csak akkor szükséges, ha a tanúsítvány még nem lett feltöltve az Azure-ba.

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

-CertificatePassword

Megadja a tanúsítvány visszafejtési jelszavát.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-Name

Megadja a webalkalmazás nevét.

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

-ResourceGroupName

Megadja annak az erőforráscsoportnak a nevét, amelyhez a tanúsítvány hozzá van rendelve. Ugyanabban a parancsban nem használhatja a ResourceGroupName paramétert és a WebApp paramétert.

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

-Slot

Megadja a webalkalmazás üzembehelyezési pontjának nevét. A Get-AzWebAppSlot parancsmaggal szerezhet be egy pontot. Az üzembehelyezési pontok lehetővé teszik a webalkalmazások üzembe helyezését és érvényesítését anélkül, hogy ezek az alkalmazások elérhetők az interneten keresztül. A módosítások általában egy átmeneti helyen lesznek üzembe helyezve, ellenőrzik ezeket a módosításokat, majd az éles (internethez elérhető) helyen helyezik üzembe őket.

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

-SslState

Megadja, hogy a tanúsítvány engedélyezve van-e. Állítsa az SSLState paramétert 1 értékre a tanúsítvány engedélyezéséhez, vagy állítsa az SSLState értékét 0 értékre a tanúsítvány letiltásához.

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

A tanúsítvány egyedi azonosítójának megadása.

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

-WebApp

Webalkalmazást ad meg. Webalkalmazás beszerzéséhez használja a Get-AzWebApp parancsmagot. A WebApp paraméter nem használható ugyanabban a parancsban, mint a ResourceGroupName paraméter és/vagy a WebAppName.

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

-WebAppName

Megadja annak a webalkalmazásnak a nevét, amelyhez az új SSL-kötés létrejön. Ugyanabban a parancsban nem használhatja a WebAppName paramétert és a WebApp paramétert.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

PSSite

Kimenetek

HostNameSslState