Add-AzApplicationGatewaySslCertificate
Hiermee voegt u een SSL-certificaat toe aan een toepassingsgateway.
Syntax
Default (Standaard)
Add-AzApplicationGatewaySslCertificate
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-CertificateFile <String>]
[-Password <SecureString>]
[-KeyVaultSecretId <String>]
[-HsmKeyId <String>]
[-HsmPublicCertData <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
De cmdlet Add-AzApplicationGatewaySslCertificate voegt een SSL-certificaat toe aan een toepassingsgateway.
Voorbeelden
Voorbeeld 1: Voeg een SSL-certificaat toe met behulp van pfx aan een toepassingsgateway.
$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
Met deze opdracht haalt u een toepassingsgateway met de naam ApplicationGateway01 op en voegt u er vervolgens een SSL-certificaat met de naam Cert01 aan toe.
Voorbeeld 2: Voeg een SSL-certificaat toe met KeyVault Secret (versieloze secretId) aan een toepassingsgateway.
$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$secret = Get-AzKeyVaultSecret -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
Haal het geheim op en verwijs ernaar in de Add-AzApplicationGatewaySslCertificate om het toe te voegen aan de Toepassingsgateway met de naam Cert01.
Opmerking: Als hier versieloze secretId wordt opgegeven, synchroniseert Application Gateway het certificaat met regelmatige tussenpozen met de KeyVault.
Voorbeeld 3: Voeg een SSL-certificaat toe met KeyVault Secret (versioned secretId) aan een toepassingsgateway.
$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$secret = Get-AzKeyVaultSecret -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id # https://<keyvaultname>.vault.azure.net/secrets/<hash>
$AppGW = Add-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId
Haal het geheim op en verwijs ernaar in de Add-AzApplicationGatewaySslCertificate om het toe te voegen aan de Toepassingsgateway met de naam Cert01.
Opmerking: als dit vereist is dat Application Gateway het certificaat synchroniseert met KeyVault, geeft u de secretId met versielozen op.
Voorbeeld 4: Een SSL-certificaat toevoegen met beheerde HSM aan een toepassingsgateway.
$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGW = Add-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -HsmKeyId "https://myhsm.managedhsm.azure.net/keys/mykey/abc123"
Voeg een SSL-certificaat toe dat verwijst naar een sleutel die is opgeslagen in beheerde HSM aan de Toepassingsgateway.
Parameters
-AcquirePolicyToken
Een Azure Policy token automatisch verkrijgen voor deze resourcebewerking.
Parametereigenschappen
Type: SwitchParameter
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-ApplicationGateway
Hiermee geeft u de naam op van de toepassingsgateway waaraan deze cmdlet een SSL-certificaat toevoegt.
Parametereigenschappen
Parametersets
(All)
Position: Named Verplicht: True Waarde uit pijplijn: True Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-CertificateFile
Hiermee geeft u het PFX-bestand van een SSL-certificaat op dat door deze cmdlet wordt toegevoegd.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-ChangeReference
De wijzigingsresource-id voor deze resourcebewerking.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-DefaultProfile
De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.
Parametereigenschappen
Type: IAzureContextContainer
Default value: None Ondersteunt jokertekens: False DontShow: False Aliassen: AzContext, AzureRmContext, AzureCredential
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-HsmKeyId
Sleutelidentificatie van een sleutel opgeslagen in Managed HSM.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-HsmPublicCertData
Met Base 64 gecodeerde openbare certificaatgegevens die overeenkomen met de sleutel die is opgeslagen in beheerde HSM.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-KeyVaultSecretId
SecretId (URI) van het KeyVault-geheim. Gebruik deze optie wanneer een specifieke versie van het geheim moet worden gebruikt.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-Name
Hiermee geeft u de naam op van het SSL-certificaat dat door deze cmdlet wordt toegevoegd.
Parametereigenschappen
Type: String
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
(All)
Position: Named Verplicht: True Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
-Password
Hiermee geeft u het wachtwoord op van het SSL-certificaat dat door deze cmdlet wordt toegevoegd.
Parametereigenschappen
Type: SecureString
Default value: None Ondersteunt jokertekens: False DontShow: False
Parametersets
(All)
Position: Named Verplicht: False Waarde uit pijplijn: False Waarde uit pijplijn op eigenschapsnaam: False Waarde van resterende argumenten: False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParameters voor meer informatie.
Uitvoerwaarden
