Add-AzApplicationGatewaySslCertificate

  • Referenz
Modul:
Az.Network

Fügt einem Anwendungsgateway ein SSL-Zertifikat hinzu.

Syntax

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

Beschreibung

Das Cmdlet Add-AzApplicationGatewaySslCertificate fügt einem Anwendungsgateway ein SSL-Zertifikat hinzu.

Beispiele

Beispiel 1: Hinzufügen eines SSL-Zertifikats mithilfe von PFX zu einem Anwendungsgateway.

$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

Dieser Befehl ruft ein Anwendungsgateway mit dem Namen ApplicationGateway01 ab und fügt ihm dann ein SSL-Zertifikat namens Cert01 hinzu.

Beispiel 2: Hinzufügen eines SSL-Zertifikats mithilfe von KeyVault Secret (version-less secretId) zu einem Anwendungsgateway.

$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$secret = Get-AzKeyVaultCertificate -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

Rufen Sie den geheimen Schlüssel ab, und verweisen Sie darauf, Add-AzApplicationGatewaySslCertificate um ihn dem Anwendungsgateway mit dem Namen Cert01hinzuzufügen. Hinweis: Da hier versionslose secretId bereitgestellt wird, synchronisiert das Anwendungsgateway das Zertifikat in regelmäßigen Abständen mit keyVault.

Beispiel 3: Hinzufügen eines SSL-Zertifikats mithilfe von KeyVault Secret (versionsed secretId) zu einem Anwendungsgateway.

$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$secret = Get-AzKeyVaultCertificate -VaultName "keyvault01" -Name "sslCert01"
$secretId = $secret.Id # https://<keyvaultname>.vault.azure.net/secrets/<hash>
$AppGW = Add-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -KeyVaultSecretId $secretId

Rufen Sie den geheimen Schlüssel ab, und verweisen Sie darauf, Add-AzApplicationGatewaySslCertificate um ihn dem Anwendungsgateway mit dem Namen Cert01hinzuzufügen. Hinweis: Wenn es erforderlich ist, dass das Anwendungsgateway das Zertifikat mit dem KeyVault synchronisiert, geben Sie die versionslose secretId an.

Parameter

-ApplicationGateway

Gibt den Namen des Anwendungsgateways an, dem dieses Cmdlet ein SSL-Zertifikat hinzufügt.

Typ:PSApplicationGateway
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CertificateFile

Gibt die PFX-Datei eines SSL-Zertifikats an, das dieses Cmdlet hinzufügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultSecretId

SecretId (uri) des Schlüsselschlüsselschlüssels. Verwenden Sie diese Option, wenn eine bestimmte Version des geheimen Schlüssels verwendet werden muss.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des SSL-Zertifikats an, das dieses Cmdlet hinzufügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Password

Gibt das Kennwort des SSL-Zertifikats an, das dieses Cmdlet hinzufügt.

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSApplicationGateway

Ausgaben

PSApplicationGateway