Set-AzApplicationGatewaySslCertificate
Atualiza um certificado SSL para um gateway de aplicativo.
Sintaxe
Default (Predefinição)
Set-AzApplicationGatewaySslCertificate
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-CertificateFile <String>]
[-Password <SecureString>]
[-KeyVaultSecretId <String>]
[-HsmKeyId <String>]
[-HsmPublicCertData <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Descrição
O cmdlet Set-AzApplicationGatewaySslCertificate atualiza um certificado SSL para um gateway de aplicativo.
Exemplos
Exemplo 1: Atualizar um certificado SSL existente no 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
Atualize um certificado SSL existente para o gateway de aplicativo chamado ApplicationGateway01.
Exemplo 2: Atualizar um certificado SSL existente usando o KeyVault Secret (secretId sem versão) no 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
Obtenha o segredo e atualize um certificado SSL existente usando Set-AzApplicationGatewaySslCertificateo .
Exemplo 3: Atualizar um certificado SSL existente usando o segredo do KeyVault no 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
Obtenha o segredo e atualize um certificado SSL existente usando Set-AzApplicationGatewaySslCertificateo .
Nota: Se for necessário que o Application Gateway sincronize o certificado com o KeyVault, forneça o secretId sem versão.
Exemplo 4: Atualizar um certificado SSL existente usando HSM gerido no 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"
Atualize um certificado SSL existente para referenciar uma chave armazenada no HSM Gerido.
Parâmetros
-AcquirePolicyToken
Adquira automaticamente um token Azure Policy para esta operação de recurso.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ApplicationGateway
Especifica o gateway de aplicativo ao qual o certificado SSL (Secure Socket Layer) está associado.
Propriedades dos parâmetros
Tipo: PSApplicationGateway
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-CertificateFile
Especifica o caminho do certificado SSL.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ChangeReference
A alteração do ID de referência do recurso para esta operação de recurso.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-HsmKeyId
Identificador de chave de uma chave armazenada no HSM Gerido.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-HsmPublicCertData
O Base-64 codificava dados de certificados públicos correspondentes à chave armazenada no HSM Gerido.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-KeyVaultSecretId
SecretId (uri) do segredo KeyVault. Use esta opção quando uma versão específica do segredo precisar ser usada.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Name
Especifica o nome do certificado SSL.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Password
Especifica a senha do certificado SSL.
Propriedades dos parâmetros
Tipo: SecureString
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
