Freigeben über


Set-AzApplicationGatewaySslCertificate

Aktualisiert ein SSL-Zertifikat für ein Anwendungsgateway.

Syntax

Default (Standard)

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

Beschreibung

Das Cmdlet Set-AzApplicationGatewaySslCertificate aktualisiert ein SSL-Zertifikat für ein Anwendungsgateway.

Beispiele

Beispiel 1: Aktualisieren eines vorhandenen SSL-Zertifikats auf dem Anwendungsgateway

$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

Aktualisieren Sie ein vorhandenes SSL-Zertifikat für das Anwendungsgateway01 für das Anwendungsgateway.

Beispiel 2: Aktualisieren eines vorhandenen SSL-Zertifikats mithilfe von KeyVault Secret (version-less secretId) auf dem Anwendungsgateway

$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

Rufen Sie den geheimen Schlüssel ab, und aktualisieren Sie ein vorhandenes SSL-Zertifikat mithilfe von Set-AzApplicationGatewaySslCertificate.

Beispiel 3: Aktualisieren eines vorhandenen SSL-Zertifikats mithilfe von KeyVault Secret auf dem Anwendungsgateway

$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

Rufen Sie den geheimen Schlüssel ab, und aktualisieren Sie ein vorhandenes SSL-Zertifikat mithilfe von Set-AzApplicationGatewaySslCertificate. Hinweis: Wenn es erforderlich ist, dass das Anwendungsgateway das Zertifikat mit dem KeyVault synchronisiert, geben Sie die versionslose secretId an.

Parameter

-ApplicationGateway

Gibt das Anwendungsgateway an, dem das SSL-Zertifikat (Secure Socket Layer) zugeordnet ist.

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 den Pfad des SSL-Zertifikats an.

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

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

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.

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