Add-AzApplicationGatewaySslCertificate

  • Riferimento
Modulo:
Az.Network

Aggiunge un certificato SSL a un gateway applicazione.

Sintassi

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

Descrizione

Il cmdlet Add-AzApplicationGatewaySslCertificate aggiunge un certificato SSL a un gateway applicazione.

Esempio

Esempio 1: Aggiungere un certificato SSL usando pfx a un gateway applicazione.

$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

Questo comando ottiene un gateway applicazione denominato ApplicationGateway01 e quindi aggiunge un certificato SSL denominato Cert01.

Esempio 2: aggiungere un certificato SSL usando il segreto KeyVault (id segreto senza versione) a un gateway applicazione.

$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

Ottenere il segreto e farvi riferimento in Add-AzApplicationGatewaySslCertificate per aggiungerlo al gateway applicazione con nome Cert01. Nota: quando viene fornito il valore secretId senza versione, gateway applicazione sincronizza il certificato a intervalli regolari con KeyVault.

Esempio 3: Aggiungere un certificato SSL usando il segreto KeyVault (secretId con versione) a un gateway applicazione.

$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

Ottenere il segreto e farvi riferimento in Add-AzApplicationGatewaySslCertificate per aggiungerlo al gateway applicazione con nome Cert01. Nota: se è necessario che gateway applicazione sincronizza il certificato con KeyVault, specificare il valore secretId senza versione.

Parametri

-ApplicationGateway

Specifica il nome del gateway applicazione a cui questo cmdlet aggiunge un certificato SSL.

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

-CertificateFile

Specifica il file pfx di un certificato SSL aggiunto da questo cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione 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 segreto dell'insieme di credenziali delle chiavi. Usare questa opzione quando è necessario usare una versione specifica del segreto.

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

-Name

Specifica il nome del certificato SSL aggiunto da questo cmdlet.

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

-Password

Specifica la password del certificato SSL aggiunto da questo cmdlet.

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

Input

PSApplicationGateway

Output

PSApplicationGateway