Set-AzApplicationGatewaySslCertificate
更新應用程式閘道的 SSL 憑證。
語法
Set-AzApplicationGatewaySslCertificate
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-CertificateFile <String>]
[-Password <SecureString>]
[-KeyVaultSecretId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Set-AzApplicationGatewaySslCertificate Cmdlet 會更新應用程式網關的 SSL 憑證。
範例
範例 1:更新應用程式閘道上現有的 SSL 憑證
$appGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -CertificateFile "D:\cert01.pfx" -Password $password
更新名為ApplicationGateway01之應用程式閘道的現有SSL憑證。
範例 2:在應用程式閘道上使用 KeyVault Secret (無版本 secretId) 更新現有的 SSL 憑證
$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id.Replace($secret.Version, "") # https://<keyvaultname>.vault.azure.net/secrets/
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId
使用 Set-AzApplicationGatewaySslCertificate
取得秘密並更新現有的 SSL 憑證。
範例 3:在應用程式閘道上使用 KeyVault 秘密更新現有的 SSL 憑證
$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id # https://<keyvaultname>.vault.azure.net/secrets/<hash>
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId
使用 Set-AzApplicationGatewaySslCertificate
取得秘密並更新現有的 SSL 憑證。
注意:如果需要應用程式閘道將憑證與 KeyVault 同步處理,請提供無版本 secretId。
參數
-ApplicationGateway
指定與安全套接字層 (SSL) 憑證相關聯的應用程式閘道。
類型: | PSApplicationGateway |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-CertificateFile
指定 SSL 憑證的路徑。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-KeyVaultSecretId
KeyVault Secret 的 SecretId (uri)。 當需要使用特定版本的秘密時,請使用此選項。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
指定 SSL 憑證的名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Password
指定 SSL 憑證的密碼。
類型: | SecureString |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |