Set-AzApplicationGatewaySslCertificate

  • リファレンス
モジュール:
Az.Network

アプリケーション ゲートウェイの SSL 証明書を更新します。

構文

Set-AzApplicationGatewaySslCertificate
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-CertificateFile <String>]
   [-Password <SecureString>]
   [-KeyVaultSecretId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Set-AzApplicationGatewaySslCertificate コマンドレットは、アプリケーション ゲートウェイの SSL 証明書を更新します。

例

例 1: Application Gateway で既存の SSL 証明書を更新する

$appGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$password = ConvertTo-SecureString $passwordPlainString -AsPlainText -Force
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -CertificateFile "D:\cert01.pfx" -Password $password

ApplicationGateway01 という名前のアプリケーション ゲートウェイの既存の SSL 証明書を更新します。

例 2: Application Gateway で KeyVault シークレット (バージョンレス 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

を使用してシークレットを取得し、既存の SSL 証明書を Set-AzApplicationGatewaySslCertificate更新します。

例 3: Application Gateway の 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

を使用してシークレットを取得し、既存の SSL 証明書を Set-AzApplicationGatewaySslCertificate更新します。 注: Application Gateway が証明書を KeyVault と同期する必要がある場合は、バージョンレスの secretId を指定してください。

パラメーター

-ApplicationGateway

Secure Socket Layer (SSL) 証明書が関連付けられているアプリケーション ゲートウェイを指定します。

Type:PSApplicationGateway
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CertificateFile

SSL 証明書のパスを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultSecretId

KeyVault シークレットの SecretId (uri)。 このオプションは、特定のバージョンのシークレットを使用する必要がある場合に使用します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

SSL 証明書の名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Password

SSL 証明書のパスワードを指定します。

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

PSApplicationGateway

出力

PSApplicationGateway