Set-AzApplicationGatewaySslCertificate

Módulo:
Az.Network Module

Actualiza un certificado SSL para una puerta de enlace de aplicaciones.

Sintaxis

Default (valor predeterminado) 

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

Description

El cmdlet Set-AzApplicationGatewaySslCertificate actualiza un certificado SSL para una puerta de enlace de aplicaciones.

Ejemplos

Ejemplo 1: Actualización de un certificado SSL existente en Application Gateway

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

Actualice un certificado SSL existente para la puerta de enlace de aplicaciones denominada ApplicationGateway01.

Ejemplo 2: Actualización de un certificado SSL existente mediante KeyVault Secret (secretId sin versión) en Application Gateway

$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id.Replace($secret.Version, "") # https://<keyvaultname>.vault.azure.net/secrets/
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId

Obtenga el secreto y actualice un certificado SSL existente mediante Set-AzApplicationGatewaySslCertificate.

Ejemplo 3: Actualización de un certificado SSL existente mediante KeyVault Secret en Application Gateway

$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id # https://<keyvaultname>.vault.azure.net/secrets/<hash>
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId

Obtenga el secreto y actualice un certificado SSL existente mediante Set-AzApplicationGatewaySslCertificate. Nota: Si es necesario que Application Gateway sincronice el certificado con KeyVault, proporcione el secretId sin versión.

Ejemplo 4: Actualización de un certificado SSL existente mediante HSM administrado en Application Gateway

$appGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$cert = Set-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -HsmKeyId "https://myhsm.managedhsm.azure.net/keys/mykey/abc123"

Actualice un certificado SSL existente para hacer referencia a una clave almacenada en HSM administrado.

Parámetros

-AcquirePolicyToken

Adquiera automáticamente un token de Azure Policy para esta operación de recursos.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ApplicationGateway

Especifica la puerta de enlace de aplicaciones con la que está asociado el certificado de capa de socket seguro (SSL).

Propiedades de parámetro

Tipo:PSApplicationGateway
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificateFile

Especifica la ruta de acceso del certificado SSL.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ChangeReference

Identificador de recurso de referencia de cambio para esta operación de recurso.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HsmKeyId

Identificador de clave de una clave almacenada en HSM gestionado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HsmPublicCertData

Datos de certificado público codificados en base 64 correspondientes a la clave almacenada en HSM administrado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-KeyVaultSecretId

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre del certificado SSL.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Password

Especifica la contraseña del certificado SSL.

Propiedades de parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSApplicationGateway

Salidas

PSApplicationGateway