Add-AzApplicationGatewaySslCertificate

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

SSL 証明書をアプリケーション ゲートウェイに追加します。

構文

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

説明

Add-AzApplicationGatewaySslCertificate コマンドレットは、SSL 証明書をアプリケーション ゲートウェイに追加します。

例

例 1: pfx を使用する SSL 証明書をアプリケーション ゲートウェイに追加する。

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

このコマンドは、ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、Cert01 という名前の SSL 証明書を追加します。

例 2: KeyVault シークレット (バージョンレス secretId) を使用して 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 参照して、名前を付けて Application Gateway に追加します Cert01。 注: バージョンレスの secretId がここに用意されているため、Application Gateway は証明書を KeyVault と定期的に同期します。

例 3: KeyVault シークレット (バージョン管理された 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 参照して、名前を付けて Application Gateway に追加します Cert01。 注: Application Gateway が証明書を KeyVault と同期する必要がある場合は、バージョンレスの secretId を指定してください。

パラメーター

-ApplicationGateway

このコマンドレットが SSL 証明書を追加するアプリケーション ゲートウェイの名前を指定します。

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

-CertificateFile

このコマンドレットが追加する SSL 証明書の .pfx ファイルを指定します。

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