Compartilhar via

Add-AzApplicationGatewaySslCertificate

  • Referência
Módulo:
Az.Network

Adiciona um certificado SSL a um gateway de aplicativo.

Sintaxe

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: adicionar um certificado SSL usando pfx a um gateway de aplicativo.

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

Esse comando obtém um gateway de aplicativo chamado ApplicationGateway01 e, em seguida, adiciona um certificado SSL chamado Cert01 a ele.

Exemplo 2: Adicionar um certificado SSL usando o segredo do KeyVault (secretId sem versão) 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 referencie-o no Add-AzApplicationGatewaySslCertificate para adicioná-lo ao Gateway de Aplicativo com o nome Cert01. Observação: como secretId sem versão é fornecido aqui, o Gateway de Aplicativo sincronizará o certificado em intervalos regulares com o KeyVault.

Exemplo 3: adicionar um certificado SSL usando o KeyVault Secret (secretId com versão) 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 referencie-o no Add-AzApplicationGatewaySslCertificate para adicioná-lo ao Gateway de Aplicativo com o nome Cert01. Observação: se for necessário que o Gateway de Aplicativo 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.

Tipo:PSApplicationGateway
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CertificateFile

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-KeyVaultSecretId

SecretId (uri) do segredo do KeyVault. Use essa opção quando uma versão específica do segredo precisar ser usada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome do certificado SSL que esse cmdlet adiciona.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Password

Especifica a senha do certificado SSL que esse cmdlet adiciona.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSApplicationGateway

Saídas

PSApplicationGateway