Set-AzApplicationGatewaySslCertificate
Uppdaterar ett SSL-certifikat för en programgateway.
Syntax
Default (Standard)
Set-AzApplicationGatewaySslCertificate
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-CertificateFile <String>]
[-Password <SecureString>]
[-KeyVaultSecretId <String>]
[-HsmKeyId <String>]
[-HsmPublicCertData <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Cmdleten Set-AzApplicationGatewaySslCertificate uppdaterar ett SSL-certifikat för en programgateway.
Exempel
Exempel 1: Uppdatera ett befintligt SSL-certifikat på 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
Uppdatera ett befintligt SSL-certifikat för programgatewayen med namnet ApplicationGateway01.
Exempel 2: Uppdatera ett befintligt SSL-certifikat med Hjälp av KeyVault Secret (versionslöst secretId) på 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
Hämta hemligheten och uppdatera ett befintligt SSL-certifikat med .Set-AzApplicationGatewaySslCertificate
Exempel 3: Uppdatera ett befintligt SSL-certifikat med hjälp av KeyVault Secret på 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
Hämta hemligheten och uppdatera ett befintligt SSL-certifikat med .Set-AzApplicationGatewaySslCertificate
Obs! Om det krävs att Application Gateway synkroniserar certifikatet med KeyVault anger du det versionslösa secretId:et.
Exempel 4: Uppdatera ett befintligt SSL-certifikat med managed HSM på 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"
Uppdatera ett befintligt SSL-certifikat för att referera till en nyckel som lagras i Managed HSM.
Parametrar
-AcquirePolicyToken
Hämta en Azure Policy token automatiskt för den här resursåtgärden.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ApplicationGateway
Anger den programgateway som SSL-certifikatet (Secure Socket Layer) är associerat med.
Parameteregenskaper
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: True
Värde från pipeline: True
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-CertificateFile
Anger sökvägen till SSL-certifikatet.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ChangeReference
Resurs-ID för ändringsreferens för den här resursåtgärden.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Parameteregenskaper
Typ: IAzureContextContainer
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-HsmKeyId
Nyckelidentifierare för en nyckel lagrad i Managed HSM.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-HsmPublicCertData
Base-64-kodade offentliga certifikatdata som motsvarar nyckeln som lagras i Managed HSM.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-KeyVaultSecretId
SecretId (uri) för KeyVault-hemligheten. Använd det här alternativet när en specifik version av hemligheten måste användas.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Name
Anger namnet på SSL-certifikatet.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Password
Anger lösenordet för SSL-certifikatet.
Parameteregenskaper
Typ: SecureString
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
Utdata