你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Add-AzApplicationGatewaySslCertificate
将 SSL 证书添加到应用程序网关。
语法
Add-AzApplicationGatewaySslCertificate
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-CertificateFile <String>]
[-Password <SecureString>]
[-KeyVaultSecretId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
说明
Add-AzApplicationGatewaySslCertificate cmdlet 向应用程序网关添加 SSL 证书。
示例
示例 1:使用 pfx 将 SSL 证书添加到应用程序网关。
$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$AppGW = Add-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -CertificateFile "D:\cert01.pfx" -Password $password
此命令获取名为 ApplicationGateway01 的应用程序网关,然后将名为 Cert01 的 SSL 证书添加到其中。
示例 2:使用 KeyVault Secret(无版本机密 Id)的 SSL 证书添加到应用程序网关。
$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$secret = Get-AzKeyVaultCertificate -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id.Replace($secret.Version, "") # https://<keyvaultname>.vault.azure.net/secrets/
$AppGW = Add-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId
获取机密并将其引用到Add-AzApplicationGatewaySslCertificate
名称Cert01
应用程序网关。
注意:此处提供了无版本 secretId,应用程序网关将定期与 KeyVault 同步证书。
示例 3:使用 KeyVault Secret(versioned secretId)将 SSL 证书添加到应用程序网关。
$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$secret = Get-AzKeyVaultCertificate -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id # https://<keyvaultname>.vault.azure.net/secrets/<hash>
$AppGW = Add-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId
获取机密并将其引用到Add-AzApplicationGatewaySslCertificate
名称Cert01
应用程序网关。
注意:如果需要应用程序网关将证书与 KeyVault 同步,请提供无版本机密 Id。
参数
-ApplicationGateway
指定此 cmdlet 向其添加 SSL 证书的应用程序网关的名称。
类型: | PSApplicationGateway |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-CertificateFile
指定此 cmdlet 添加的 SSL 证书的 .pfx 文件。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-KeyVaultSecretId
KeyVault 机密的 SecretId (uri)。 当需要使用特定版本的机密时,请使用此选项。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
指定此 cmdlet 添加的 SSL 证书的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Password
指定此 cmdlet 添加的 SSL 证书的密码。
类型: | SecureString |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |