az network vpn-connection shared-key

Is this page helpful?

Any additional feedback?

Feedback will be sent to Microsoft: By pressing the submit button, your feedback will be used to improve Microsoft products and services. Privacy policy.

Manage VPN shared keys.

Commands

az network vpn-connection shared-key reset	Reset a VPN connection shared key.
az network vpn-connection shared-key show	Retrieve a VPN connection shared key.
az network vpn-connection shared-key update	Update a VPN connection shared key.

az network vpn-connection shared-key reset

Reset a VPN connection shared key.

az network vpn-connection shared-key reset --key-length
                                           [--connection-name]
                                           [--ids]
                                           [--resource-group]

Examples

Reset the shared key on a connection.

az network vpn-connection shared-key reset -g MyResourceGroup --connection-name MyConnection --key-length 128

Reset a VPN connection shared key. (autogenerated)

az network vpn-connection shared-key reset --connection-name MyConnection --key-length 128 --resource-group MyResourceGroup --subscription MySubscription

Required Parameters

--key-length

The virtual network connection reset shared key length, should between 1 and 128.

Optional Parameters

--connection-name

Connection name.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network vpn-connection shared-key show

Retrieve a VPN connection shared key.

az network vpn-connection shared-key show [--connection-name]
                                          [--ids]
                                          [--resource-group]

Examples

View the shared key of a connection.

az network vpn-connection shared-key show -g MyResourceGroup --connection-name MyConnection

Retrieve a VPN connection shared key. (autogenerated)

az network vpn-connection shared-key show --connection-name MyConnection --resource-group MyResourceGroup --subscription MySubscription

Optional Parameters

--connection-name

Connection name.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network vpn-connection shared-key update

Update a VPN connection shared key.

az network vpn-connection shared-key update --value
                                            [--add]
                                            [--connection-name]
                                            [--force-string]
                                            [--ids]
                                            [--remove]
                                            [--resource-group]
                                            [--set]

Examples

Change the shared key for the connection to "Abc123".

az network vpn-connection shared-key update -g MyResourceGroup --connection-name MyConnection --value Abc123

Update a VPN connection shared key. (autogenerated)

az network vpn-connection shared-key update --connection-name MyConnection --resource-group MyResourceGroup --subscription MySubscription --value Abc123

Required Parameters

--value

The virtual network connection shared key value.

Optional Parameters

--add

Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.

--connection-name

Connection name.

--force-string

When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--remove

Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--set

Update an object by specifying a property path and value to set. Example: --set property1.property2=.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.