New-AzureRmWebAppSSLBinding
SSL-tanúsítványkötést hoz létre egy Azure-webalkalmazáshoz.
Figyelmeztetés
Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.
Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.
Syntax
New-AzureRmWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
A New-AzureRmWebAppSSLBinding 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
PS C:\>New-AzureRmWebAppSSLBinding -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.
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 |
-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: | 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-AzureRMWebAppSlot 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-AzureRmWebApp 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 |
Bevitelek
Paraméterek: WebApp (ByValue)