New-AzWebAppSSLBinding
建立 Azure Web 應用程式的 SSL 憑證系結。
語法
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
New-AzWebAppSSLBinding Cmdlet 會為 Azure Web 應用程式建立安全套接字層 （SSL） 憑證系結。 Cmdlet 會以兩種方式建立 SSL 系結：
- 您可以將 Web 應用程式系結至現有的憑證。
- 您可以上傳新的憑證，然後將 Web 應用程式系結至這個新的憑證。 無論您使用哪種方法，憑證和 Web 應用程式都必須與相同的 Azure 資源群組相關聯。 如果您有資源群組 A 中的 Web 應用程式，而且想要將該 Web 應用程式系結至資源群組 B 中的憑證，唯一的方法就是將憑證複本上傳至資源群組 A。如果您上傳新的憑證，請記住 Azure SSL 憑證的下列需求：
- 憑證必須包含私密金鑰。
- 憑證必須使用個人資訊交換 （PFX） 格式。
- 憑證的主體名稱必須符合用來存取 Web 應用程式的網域。
- 憑證至少必須以 2048 位元加密。
範例
範例 1：將憑證系結至 Web 應用程式
New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"此命令會將現有的 Azure 憑證（具有指紋E3A38EBA60CAA1C162785A2E1C44A15AD450199C3的憑證）系結至名為 ContosoWebApp 的 Web 應用程式。
範例 2
建立 Azure Web 應用程式的 SSL 憑證系結。 （ 自動產生 ）
New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'powershell
範例 3
建立 Azure Web 應用程式的 SSL 憑證系結。 （ 自動產生 ）
New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'參數
-CertificateFilePath
指定要上傳之憑證的檔案路徑。 只有在憑證尚未上傳至 Azure 時，才需要 CertificateFilePath 參數。
| 類型: | String |
| Position: | 4 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CertificatePassword
指定憑證的解密密碼。
| 類型: | String |
| Position: | 5 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定 Web 應用程式的名稱。
| 類型: | String |
| Position: | 3 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ResourceGroupName
指定指派憑證的資源群組名稱。 您無法在 相同的命令中使用 ResourceGroupName 參數和 WebApp 參數。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Slot
指定 Web 應用程式部署位置的名稱。 您可以使用 Get-AzWebAppSlot Cmdlet 來取得位置。 部署位置可讓您暫存及驗證 Web 應用程式，而不需要透過因特網存取這些應用程式。 一般而言，您會將變更部署至預備網站、驗證這些變更，然後部署到生產環境 （因特網可存取） 月臺。
| 類型: | String |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SslState
指定是否啟用憑證。 將 SSLState 參數設定為 1 以啟用憑證，或將 SSLState 設定為 0 以停用憑證。
| 類型: | Nullable<T>[SslState] |
| 接受的值: | Disabled, SniEnabled, IpBasedEnabled |
| Position: | 4 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Thumbprint
指定憑證的唯一標識符。
| 類型: | String |
| Position: | 6 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WebApp
指定 Web 應用程式。 若要取得 Web 應用程式，請使用 Get-AzWebApp Cmdlet。 您無法在與 ResourceGroupName 參數和/或 WebAppName 相同的命令中使用 WebApp 參數。
| 類型: | PSSite |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WebAppName
指定要建立新 SSL 系結的 Web 應用程式名稱。 您無法在同 一個命令中使用 WebAppName 參數和 WebApp 參數。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
