Add-AzApplicationGatewaySslCertificate

  • Referência
Módulo:
Az.Network

Adiciona um certificado SSL a um gateway de aplicativo.

Syntax

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

Description

O cmdlet Add-AzApplicationGatewaySslCertificate adiciona um certificado SSL a um gateway de aplicativo.

Exemplos

Exemplo 1: Adicione um certificado SSL usando pfx a um gateway de aplicativo.

$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 obtém um gateway de aplicativo chamado ApplicationGateway01 e, em seguida, adiciona um certificado SSL chamado Cert01 a ele.

Exemplo 2: Adicione um certificado SSL usando KeyVault Secret (version-less secretId) a um gateway de aplicativo.

$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

Obtenha o segredo e faça referência a ele no Add-AzApplicationGatewaySslCertificate para adicioná-lo ao Application Gateway com o nome Cert01. Nota: Como secretId sem versão é fornecido aqui, o Application Gateway sincronizará o certificado em intervalos regulares com o KeyVault.

Exemplo 3: Adicione um certificado SSL usando KeyVault Secret (versioned secretId) a um gateway de aplicativo.

$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

Obtenha o segredo e faça referência a ele no Add-AzApplicationGatewaySslCertificate para adicioná-lo ao Application Gateway com o nome Cert01. Nota: Se for necessário que o Application Gateway sincronize o certificado com o KeyVault, forneça o secretId sem versão.

Parâmetros

-ApplicationGateway

Especifica o nome do gateway de aplicativo ao qual esse cmdlet adiciona um certificado SSL.

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

-CertificateFile

Especifica o arquivo .pfx de um certificado SSL que esse cmdlet adiciona.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o 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) do segredo KeyVault. Use esta opção quando uma versão específica do segredo precisar ser usada.

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

-Name

Especifica o nome do certificado SSL que este cmdlet adiciona.

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

-Password

Especifica a senha do certificado SSL que este cmdlet adiciona.

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

Entradas

PSApplicationGateway

Saídas

PSApplicationGateway