az network vpn-connection shared-key

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

Edit

Reset a VPN connection shared key.

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

Examples

Reset the shared key on a connection.

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

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

--subscription

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

az network vpn-connection shared-key show

Edit

Retrieve a VPN connection shared key.

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

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.

--query-examples

Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.

--resource-group -g

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

--subscription

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

az network vpn-connection shared-key update

Edit

Update a VPN connection shared key.

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

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.

--id

Resource ID.

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

--subscription

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