az storage share-rm

Manage Azure file shares using the Microsoft.Storage resource provider.

Commands

az storage share-rm create

Create a new Azure file share under the specified storage account.

az storage share-rm delete

Delete the specified Azure file share.

az storage share-rm exists

Check for the existence of an Azure file share.

az storage share-rm list

List the Azure file shares under the specified storage account.

az storage share-rm restore

Restore a file share within a valid retention days if share soft delete is enabled.

az storage share-rm show

Show the properties for a specified Azure file share.

az storage share-rm stats

Get the usage bytes of the data stored on the share.

az storage share-rm update

Update the properties for an Azure file share.

az storage share-rm create

Create a new Azure file share under the specified storage account.

az storage share-rm create --name
                           --storage-account
                           [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                           [--enabled-protocols {NFS, SMB}]
                           [--metadata]
                           [--quota]
                           [--resource-group]
                           [--root-squash {AllSquash, NoRootSquash, RootSquash}]
                           [--subscription]

Examples

Create a new Azure file share 'myfileshare' with metadata and quota as 10 GB under the storage account 'mystorageaccount'(account name) in resource group 'MyResourceGroup'.

az storage share-rm create -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 10 --metadata key1=value1 key2=value2

Create a new Azure file share 'myfileshare' with metadata and quota as 6000 GB under the storage account 'mystorageaccount'(account name) which enables large file share in resource group 'MyResourceGroup'.

az storage account update -g MyResourceGroup --name mystorageaccount --enable-large-file-share
az storage share-rm create -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 6000 --metadata key1=value1 key2=value2

Create a new Azure file share 'myfileshare' with metadata and quota as 10 GB under the storage account 'mystorageaccount' (account id).

az storage share-rm create --storage-account mystorageaccount --name myfileshare --quota 10 --metadata key1=value1 key2=value2

Required Parameters

--name -n

The file share name.

--storage-account

The name or ID of the storage account.

Optional Parameters

--access-tier

Access tier for specific share. GpV2 account can choose between TransactionOptimized (default), Hot, and Cool. FileStorage account can choose Premium.

accepted values: Cool, Hot, Premium, TransactionOptimized
--enabled-protocols

Immutable property for file shares protocol. NFS protocol will be only available for premium file shares (file shares in the FileStorage account type).

accepted values: NFS, SMB
--metadata

Metadata in space-separated key=value pairs that is associated with the share. This overwrites any existing metadata.

--quota -q

The maximum size of the share in gigabytes. Must be greater than 0, and less than or equal to 5TB (5120). For Large File Shares, the maximum size is 102400.

--resource-group -g

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

--root-squash

Reduction of the access rights for the remote superuser.

accepted values: AllSquash, NoRootSquash, RootSquash
--subscription

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

az storage share-rm delete

Delete the specified Azure file share.

az storage share-rm delete [--ids]
                           [--name]
                           [--resource-group]
                           [--storage-account]
                           [--subscription]
                           [--yes]

Examples

Delete an Azure file share 'myfileshare' under the storage account 'mystorageaccount' (account name) in resource group 'MyResourceGroup'.

az storage share-rm delete -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Delete an Azure file share 'myfileshare' under the storage account 'mystorageaccount' (account id).

az storage share-rm delete --storage-account mystorageaccount --name myfileshare

Delete an Azure file share by resource id.

az storage share-rm delete --ids file-share-id

Optional Parameters

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

--name -n

The file share name.

--resource-group -g

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

--storage-account

The name or ID of the storage account.

--subscription

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

--yes -y

Do not prompt for confirmation.

az storage share-rm exists

Check for the existence of an Azure file share.

az storage share-rm exists [--ids]
                           [--name]
                           [--resource-group]
                           [--storage-account]
                           [--subscription]

Examples

Check for the existence of an Azure file share 'myfileshare' under the storage account 'mystorageaccount' (account name) in resource group 'MyResourceGroup'.

az storage share-rm exists -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Check for the existence of an Azure file share 'myfileshare' under the storage account 'mystorageaccount' (account id).

az storage share-rm exists --storage-account mystorageaccount --name myfileshare

Check for the existence of an Azure file share by resource id.

az storage share-rm exists --ids file-share-id

Optional Parameters

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

--name -n

The file share name.

--resource-group -g

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

--storage-account

The name or ID of the storage account.

--subscription

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

az storage share-rm list

List the Azure file shares under the specified storage account.

az storage share-rm list --storage-account
                         [--include-deleted]
                         [--query-examples]
                         [--resource-group]
                         [--subscription]

Examples

List the Azure file shares under the storage account 'mystorageaccount' (account name) in resource group 'MyResourceGroup'.

az storage share-rm list -g MyResourceGroup --storage-account mystorageaccount

List the Azure file shares under the storage account 'mystorageaccount' (account id).

az storage share-rm list --storage-account mystorageaccount

List all file shares include deleted under the storage account 'mystorageaccount' .

az storage share-rm list --storage-account mystorageaccount --include-deleted

Required Parameters

--storage-account

The name or ID of the storage account.

Optional Parameters

--include-deleted

Include soft deleted file shares when specified.

--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 storage share-rm restore

Restore a file share within a valid retention days if share soft delete is enabled.

az storage share-rm restore --deleted-version
                            [--ids]
                            [--name]
                            [--resource-group]
                            [--restored-name]
                            [--storage-account]
                            [--subscription]

Examples

Restore a file share within a valid retention days if share soft delete is enabled.

az storage share-rm restore -n deletedshare --deleted-version 01D64EB9886F00C4 -g MyResourceGroup --storage-account mystorageaccount

Restore a file share within a valid retention days if share soft delete is enabled to a new name.

az storage share-rm restore -n deletedshare --deleted-version 01D64EB9886F00C4 --restored-name newname -g MyResourceGroup --storage-account mystorageaccount

Required Parameters

--deleted-version

Identify the version of the deleted share that will be restored.

Optional Parameters

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

--name -n

The file share name. Identify the name of the deleted share that will be restored.

--resource-group -g

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

--restored-name

A new file share name to be restored. If not specified, deleted share name will be used.

--storage-account

The name or ID of the storage account.

--subscription

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

az storage share-rm show

Show the properties for a specified Azure file share.

az storage share-rm show [--expand]
                         [--ids]
                         [--name]
                         [--query-examples]
                         [--resource-group]
                         [--storage-account]
                         [--subscription]

Examples

Show the properties for an Azure file share 'myfileshare' under the storage account 'mystorageaccount' (account name) in resource group 'MyResourceGroup'.

az storage share-rm show -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Show the properties for an Azure file share 'myfileshare' under the storage account 'mystorageaccount' (account id).

az storage share-rm show --storage-account mystorageaccount --name myfileshare

Show the properties of an Azure file shares by resource id.

az storage share-rm show --ids file-share-id

Optional Parameters

--expand

Optional, used to expand the properties within share's properties.

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

--name -n

The file share name.

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

--storage-account

The name or ID of the storage account.

--subscription

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

az storage share-rm stats

Get the usage bytes of the data stored on the share.

az storage share-rm stats [--ids]
                          [--name]
                          [--resource-group]
                          [--storage-account]
                          [--subscription]

Examples

Get the usage bytes of the data stored on the share.

az storage share-rm stats -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Optional Parameters

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

--name -n

The file share name.

--resource-group -g

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

--storage-account

The name or ID of the storage account.

--subscription

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

az storage share-rm update

Update the properties for an Azure file share.

az storage share-rm update [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                           [--add]
                           [--force-string]
                           [--ids]
                           [--metadata]
                           [--name]
                           [--quota]
                           [--remove]
                           [--resource-group]
                           [--root-squash {AllSquash, NoRootSquash, RootSquash}]
                           [--set]
                           [--storage-account]
                           [--subscription]

Examples

Update the properties for an Azure file share 'myfileshare' under the storage account 'mystorageaccount' (account name) in resource group 'MyResourceGroup'.

az storage share-rm update -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 3 --metadata key1=value1 key2=value2

Update the properties for an Azure file share 'myfileshare' under the storage account 'mystorageaccount' (account id).

az storage share-rm update --storage-account mystorageaccount --name myfileshare --quota 3 --metadata key1=value1 key2=value2

Update the properties for an Azure file shares by resource id.

az storage share-rm update --ids file-share-id --quota 3 --metadata key1=value1 key2=value2

Optional Parameters

--access-tier

Access tier for specific share. GpV2 account can choose between TransactionOptimized (default), Hot, and Cool. FileStorage account can choose Premium.

accepted values: Cool, Hot, Premium, TransactionOptimized
--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>.

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

--metadata

Metadata in space-separated key=value pairs that is associated with the share. This overwrites any existing metadata.

--name -n

The file share name.

--quota -q

The maximum size of the share in gigabytes. Must be greater than 0, and less than or equal to 5TB (5120). For Large File Shares, the maximum size is 102400.

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

--root-squash

Reduction of the access rights for the remote superuser.

accepted values: AllSquash, NoRootSquash, RootSquash
--set

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

--storage-account

The name or ID of the storage account.

--subscription

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