Add-AzApplicationGatewaySslCertificate

  • Referencia
Módulo:
Az.Network

Agrega un certificado SSL a una puerta de enlace de aplicaciones.

Syntax

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

Description

El cmdlet Add-AzApplicationGatewaySslCertificate agrega un certificado SSL a una puerta de enlace de aplicaciones.

Ejemplos

Ejemplo 1: Agregar un certificado SSL mediante pfx a una puerta de enlace de aplicaciones.

$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

Este comando obtiene una puerta de enlace de aplicaciones denominada ApplicationGateway01 y, a continuación, agrega un certificado SSL denominado Cert01.

Ejemplo 2: Agregar un certificado SSL mediante KeyVault Secret (secretId sin versión) a una puerta de enlace de aplicaciones.

$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

Obtenga el secreto y haga referencia a él en Add-AzApplicationGatewaySslCertificate para agregarlo a Application Gateway con el nombre Cert01. Nota: A medida que se proporciona secretId sin versión aquí, Application Gateway sincronizará el certificado en intervalos regulares con KeyVault.

Ejemplo 3: Adición de un certificado SSL mediante KeyVault Secret (secretId con versiones) a una puerta de enlace de aplicaciones.

$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

Obtenga el secreto y haga referencia a él en Add-AzApplicationGatewaySslCertificate para agregarlo a Application Gateway con el nombre Cert01. Nota: Si es necesario que Application Gateway sincronice el certificado con KeyVault, proporcione el secretId sin versión.

Parámetros

-ApplicationGateway

Especifica el nombre de la puerta de enlace de aplicaciones a la que este cmdlet agrega un certificado SSL.

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

-CertificateFile

Especifica el archivo .pfx de un certificado SSL que agrega este cmdlet.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

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

-KeyVaultSecretId

SecretId (uri) del secreto de KeyVault. Use esta opción cuando se necesite usar una versión específica del secreto.

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

-Name

Especifica el nombre del certificado SSL que agrega este cmdlet.

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

-Password

Especifica la contraseña del certificado SSL que agrega este cmdlet.

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

Entradas

PSApplicationGateway

Salidas

PSApplicationGateway