Edit

Share via


Set-AzApplicationGatewaySslPolicy

Modifies the SSL policy of an application gateway.

Syntax

Default (Default)

Set-AzApplicationGatewaySslPolicy
    -ApplicationGateway <PSApplicationGateway>
    [-DisabledSslProtocols <String[]>]
    [-PolicyType <String>]
    [-PolicyName <String>]
    [-CipherSuite <String[]>]
    [-MinProtocolVersion <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Set-AzApplicationGatewaySslPolicy cmdlet modifies the SSL policy of an application gateway.

Examples

Example 1

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewaySslPolicy -ApplicationGateway $getgw -PolicyType Predefined -PolicyName AppGwSslPolicy20170401

The first command gets the application gateway named ApplicationGateway01 and stores it in the $AppGw variable. This second command modifies the ssl policy to a policy type Predefined and policy name AppGwSslPolicy20170401.

Example 2

Modifies the SSL policy of an application gateway. (autogenerated)

Set-AzApplicationGatewaySslPolicy -ApplicationGateway <PSApplicationGateway> -CipherSuite 'TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256' -MinProtocolVersion TLSv1_0 -PolicyType Predefined

Parameters

-ApplicationGateway

Specifies the application gateway of the SSL policy that this cmdlet modifies.

Parameter properties

Type:PSApplicationGateway
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-CipherSuite

Ssl cipher suites to be enabled in the specified order to application gateway

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure.

Parameter properties

Type:IAzureContextContainer
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisabledSslProtocols

Specifies which protocols are disabled. The acceptable values for this parameter are:

  • TLSv1_0
  • TLSv1_1
  • TLSv1_2

Parameter properties

Type:

String[]

Default value:None
Accepted values:TLSv1_0, TLSv1_1, TLSv1_2, TLSv1_3
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MinProtocolVersion

Minimum version of Ssl protocol to be supported on application gateway

Parameter properties

Type:String
Default value:None
Accepted values:TLSv1_0, TLSv1_1, TLSv1_2, TLSv1_3
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PolicyName

Name of Ssl predefined policy

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PolicyType

Type of Ssl Policy

Parameter properties

Type:String
Default value:None
Accepted values:Predefined, Custom, CustomV2
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

PSApplicationGateway

Outputs

PSApplicationGateway

Notes

  • Keywords: azure, azurerm, arm, resource, management, manager, network, networking