Set-AzApplicationGatewayClientAuthConfiguration

Modul:
Az.Network Module

Ändert die Clientauthentifizierungskonfiguration eines SSL-Profilobjekts.

Syntax

Default (Standard) 

Set-AzApplicationGatewayClientAuthConfiguration
    -SslProfile <PSApplicationGatewaySslProfile>
    [-VerifyClientCertIssuerDN]
    [-VerifyClientRevocation <String>]
    [-VerifyClientAuthMode <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzApplicationGatewayClientAuthConfiguration ändert die Clientauthentifizierungskonfiguration eines SSL-Profilobjekts.

Beispiele

Beispiel 1

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$profile  = Get-AzApplicationGatewaySslProfile -Name "SslProfile01" -ApplicationGateway $AppGw
Set-AzApplicationGatewayClientAuthConfiguration -SslProfile $profile -VerifyClientCertIssuerDN -VerifyClientRevocation OCSP

Der erste Befehl ruft das Anwendungsgateway01 in der Ressourcengruppe "ResourceGroup01" ab und speichert es in der $AppGw Variablen. Der zweite Befehl ruft das ssl-Profil "SslProfile01" für $AppGw ab und speichert die Einstellungen in der $profile Variablen. Mit dem letzten Befehl wird die Clientauthentifizierungskonfiguration des in $profile gespeicherten SSL-Profilobjekts geändert.

Beispiel 2: Switch a ssl profile to mutual TLS (mTLS) passthrough

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$profile = Get-AzApplicationGatewaySslProfile -Name "SslProfile01" -ApplicationGateway $AppGw
Set-AzApplicationGatewayClientAuthConfiguration -SslProfile $profile -VerifyClientAuthMode Passthrough
Set-AzApplicationGateway -ApplicationGateway $AppGw

Die letzten beiden Befehle legen die Clientauthentifizierungskonfiguration des SSL-Profils auf den Passthrough-Modus fest und speichern die Änderung auf dem Anwendungsgateway. Im Passthrough-Modus wird das Clientzertifikat an das Back-End weitergeleitet, ohne vom Anwendungsgateway überprüft zu werden.

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

-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

-SslProfile

Das SSL-Profil

Parametereigenschaften

Typ:PSApplicationGatewaySslProfile
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

-VerifyClientAuthMode

Clientzertifikatüberprüfungsmodus. Im Passthrough-Modus leitet das Anwendungsgateway das Clientzertifikat an das Back-End weiter, ohne es zu überprüfen.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Strict, Passthrough
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

-VerifyClientCertIssuerDN

Überprüfen Sie den Clientzertifikatsperrstatus.

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

-VerifyClientRevocation

Überprüfen Sie den Namen des Clientzertifikatherausgebers.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:None, OCSP
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

PSApplicationGatewaySslProfile

Ausgaben

PSApplicationGatewaySslProfile