New-AzWebAppSSLBinding
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.
| Típus: | String |
| Position: | 4 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-CertificatePassword
Megadja a tanúsítvány visszafejtési jelszavát.
| Típus: | String |
| Position: | 5 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
| Típus: | SwitchParameter |
| Aliasok: | cf |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
| Típus: | IAzureContextContainer |
| Aliasok: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a webalkalmazás nevét.
| Típus: | String |
| Position: | 3 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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.
| Típus: | String |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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.
| Típus: | String |
| Position: | 2 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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.
| Típus: | Nullable<T>[SslState] |
| Elfogadott értékek: | Disabled, SniEnabled, IpBasedEnabled |
| Position: | 4 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Thumbprint
A tanúsítvány egyedi azonosítójának megadása.
| Típus: | String |
| Position: | 6 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | 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.
| Típus: | PSSite |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | 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.
| Típus: | String |
| Position: | 1 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
| Típus: | SwitchParameter |
| Aliasok: | wi |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
