Add-AzApplicationGatewaySslCertificate

Modul:
Az.Network Module

Fügt einem Anwendungsgateway ein SSL-Zertifikat hinzu.

Syntax

Default (Standard) 

Add-AzApplicationGatewaySslCertificate
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-CertificateFile <String>]
    [-Password <SecureString>]
    [-KeyVaultSecretId <String>]
    [-HsmKeyId <String>]
    [-HsmPublicCertData <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-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

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-AzKeyVaultSecret -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.

Beispiel 4: Hinzufügen eines SSL-Zertifikats mit verwaltetem HSM zu einem Anwendungsgateway.

$AppGW = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGW = Add-AzApplicationGatewaySslCertificate -ApplicationGateway $AppGW -Name "Cert01" -HsmKeyId "https://myhsm.managedhsm.azure.net/keys/mykey/abc123"

Fügen Sie dem Anwendungsgateway ein SSL-Zertifikat hinzu, das auf einen in managed HSM gespeicherten Schlüssel verweist.

Parameter

-AcquirePolicyToken

Rufen Sie automatisch ein Azure Policy Token für diesen Ressourcenvorgang ab.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ApplicationGateway

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

Parametereigenschaften

Typ:PSApplicationGateway
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CertificateFile

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ChangeReference

Die Änderungsreferenzressourcen-ID für diesen Ressourcenvorgang.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-HsmKeyId

Schlüsselkennung eines Schlüssels, der im verwalteten HSM gespeichert ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-HsmPublicCertData

Base64-codierte öffentliche Zertifikatdaten, die dem in verwalteten HSM gespeicherten Schlüssel entsprechen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-KeyVaultSecretId

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Password

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

Parametereigenschaften

Typ:SecureString
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSApplicationGateway

Ausgaben

PSApplicationGateway