Add-AzApplicationGatewaySslCertificate
Ajoute un certificat SSL à une passerelle d’application.
Syntaxe
Default (Par défaut)
Add-AzApplicationGatewaySslCertificate
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-CertificateFile <String>]
[-Password <SecureString>]
[-KeyVaultSecretId <String>]
[-HsmKeyId <String>]
[-HsmPublicCertData <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande Add-AzApplicationGatewaySslCertificate ajoute un certificat SSL à une passerelle d’application.
Exemples
Exemple 1 : Ajoutez un certificat SSL à l’aide de pfx à une passerelle d’application.
$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
Cette commande obtient une passerelle d’application nommée ApplicationGateway01, puis ajoute un certificat SSL nommé Cert01 à celui-ci.
Exemple 2 : Ajoutez un certificat SSL à l’aide du secret KeyVault (version-sans secretId) à une passerelle d’application.
$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
Obtenez le secret et référencez-le dans le Add-AzApplicationGatewaySslCertificate pour l’ajouter à Application Gateway avec le nom Cert01.
Remarque : à mesure que le secretId sans version est fourni ici, Application Gateway synchronise le certificat à intervalles réguliers avec keyVault.
Exemple 3 : Ajoutez un certificat SSL à l’aide du secret KeyVault (secretId versionné) à une passerelle d’application.
$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
Obtenez le secret et référencez-le dans le Add-AzApplicationGatewaySslCertificate pour l’ajouter à Application Gateway avec le nom Cert01.
Remarque : S’il est nécessaire que Application Gateway synchronise le certificat avec keyVault, indiquez le secretId sans version.
Exemple 4 : Ajoutez un certificat SSL à l’aide de HSM managé à une passerelle d’application.
$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGW = Add-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -HsmKeyId "https://myhsm.managedhsm.azure.net/keys/mykey/abc123"
Ajoutez un certificat SSL référençant une clé stockée dans le HSM managé à Application Gateway.
Paramètres
-AcquirePolicyToken
Acquérir automatiquement un jeton Azure Policy pour cette opération de ressource.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ApplicationGateway
Spécifie le nom de la passerelle d’application à laquelle cette applet de commande ajoute un certificat SSL.
Propriétés du paramètre
Type: PSApplicationGateway
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: True Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-CertificateFile
Spécifie le fichier .pfx d’un certificat SSL ajouté par cette applet de commande.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ChangeReference
ID de ressource de référence de modification pour cette opération de ressource.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Propriétés du paramètre
Type: IAzureContextContainer
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-HsmKeyId
Identifiant de clé d’une clé stockée dans Managed HSM.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-HsmPublicCertData
Données de certificat public codées en base 64 correspondant à la clé stockée dans le HSM managé.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-KeyVaultSecretId
SecretId (uri) du secret KeyVault. Utilisez cette option lorsqu’une version spécifique du secret doit être utilisée.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Name
Spécifie le nom du certificat SSL ajouté par cette applet de commande.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Password
Spécifie le mot de passe du certificat SSL ajouté par cette applet de commande.
Propriétés du paramètre
Type: SecureString
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties
