Compartir a través de


az storage share-rm

Administre recursos compartidos de archivos de Azure mediante el proveedor de recursos Microsoft.Storage.

Comandos

Nombre Description Tipo Estado
az storage share-rm create

Cree un recurso compartido en la cuenta especificada como se describe en el cuerpo de la solicitud. El recurso compartido incluye metadatos y propiedades para ese recurso compartido. No incluye una lista de los archivos contenidos en el recurso compartido.

Core GA
az storage share-rm delete

Elimine el recurso compartido de archivos de Azure especificado o la instantánea de recurso compartido.

Core GA
az storage share-rm exists

Compruebe la existencia de un recurso compartido de archivos de Azure.

Core GA
az storage share-rm list

Enumera todos los recursos compartidos.

Core GA
az storage share-rm restore

Restaure un recurso compartido de archivos dentro de los días de retención válidos si está habilitada la eliminación temporal del recurso compartido.

Core GA
az storage share-rm show

Muestra las propiedades de un recurso compartido de archivos de Azure o una instantánea de recurso compartido especificados.

Core GA
az storage share-rm snapshot

Cree una instantánea de un recurso compartido existente en la cuenta especificada.

Core Preview
az storage share-rm stats

obtiene los bytes de uso de los datos almacenados en el recurso compartido.

Core GA
az storage share-rm update

Actualice un nuevo recurso compartido en la cuenta especificada como se describe en el cuerpo de la solicitud. El recurso compartido incluye metadatos y propiedades para ese recurso compartido. No incluye una lista de los archivos contenidos en el recurso compartido.

Core GA

az storage share-rm create

Cree un recurso compartido en la cuenta especificada como se describe en el cuerpo de la solicitud. El recurso compartido incluye metadatos y propiedades para ese recurso compartido. No incluye una lista de los archivos contenidos en el recurso compartido.

az storage share-rm create --account-name --storage-account
                           --name --share-name
                           [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                           [--bursting-max-mibps --paid-bursting-max-bandwidth-mibps]
                           [--enabled-protocols {NFS, SMB}]
                           [--metadata]
                           [--paid-bursting-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                           [--paid-bursting-max-iops]
                           [--provisioned-bandwidth --provisioned-bandwidth-mibps]
                           [--provisioned-iops]
                           [--quota]
                           [--resource-group]
                           [--root-squash {AllSquash, NoRootSquash, RootSquash}]

Ejemplos

Cree un nuevo recurso compartido de archivos de Azure "myfileshare" con metadatos y cuota como 10 GB en la cuenta de almacenamiento "mystorageaccount" (nombre de cuenta) en el grupo de recursos "MyResourceGroup".

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

Cree un nuevo recurso compartido de archivos de Azure "myfileshare" con metadatos y cuota de 6000 GB en la cuenta de almacenamiento "mystorageaccount" (nombre de cuenta) que permite un recurso compartido de archivos grande en el grupo de recursos "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

Cree un nuevo recurso compartido de archivos de Azure "myfileshare" con metadatos y cuota como 10 GB en la cuenta de almacenamiento "mystorageaccount" (identificador de cuenta).

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

Cree un nuevo recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount", que habilita provisionedv2 en el grupo de recursos "MyResourceGroup".

az storage account create -g res3376 --name sto328 --sku StandardV2_LRS --kind FileStorage
az storage share-rm create --storage-account sto328  -g res3376  -n share1 --provisioned-bandwidth-mibps 60 --provisioned-iops 500

Parámetros requeridos

--account-name --storage-account

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas.

--name --share-name -n

Nombre del recurso compartido de archivos dentro de la cuenta de almacenamiento especificada. Los nombres de recursos compartidos de archivos deben tener entre 3 y 63 caracteres de longitud y usar números, letras minúsculas y guiones (-). Cada carácter de guión (-) debe ir precedido inmediatamente y seguido de una letra o número.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--access-tier

Nivel de acceso para un recurso compartido específico. La cuenta de GpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta FileStorage puede elegir Premium.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Cool, Hot, Premium, TransactionOptimized
--bursting-max-mibps --paid-bursting-max-bandwidth-mibps

Ancho de banda máximo de expansión de pago para el recurso compartido, en mebibytes por segundo. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files. El valor máximo permitido es 10340, que es el ancho de banda máximo permitido para un recurso compartido.

Propiedad Valor
Grupo de parámetros: Provisioned V1 Paid Bursting Arguments
--enabled-protocols

Protocolo de autenticación que se usa para el recurso compartido de archivos. El protocolo NFS solo estará disponible para recursos compartidos de archivos Premium (recursos compartidos de archivos en el tipo de cuenta FileStorage). Solo se puede especificar al crear un recurso compartido.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: NFS, SMB
--metadata

Par nombre-valor que se va a asociar al recurso compartido como metadatos. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--paid-bursting-enabled

Indica si la expansión de pago está habilitada para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files.

Propiedad Valor
Grupo de parámetros: Provisioned V1 Paid Bursting Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--paid-bursting-max-iops

Número máximo de IOPS de expansión de pago para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files. El valor máximo permitido es 102400, que es el valor máximo permitido de IOPS para un recurso compartido.

Propiedad Valor
Grupo de parámetros: Provisioned V1 Paid Bursting Arguments
--provisioned-bandwidth --provisioned-bandwidth-mibps

Ancho de banda aprovisionado del recurso compartido, en mebibytes por segundo. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos. Consulte la respuesta de la API GetFileServiceUsage para obtener el valor mínimo y máximo permitido para el ancho de banda aprovisionado.

Propiedad Valor
Grupo de parámetros: Provisioned V2 Arguments
--provisioned-iops

IOPS aprovisionadas del recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos. Consulte la respuesta de la API GetFileServiceUsage para obtener el valor mínimo y máximo permitido para IOPS aprovisionadas.

Propiedad Valor
Grupo de parámetros: Provisioned V2 Arguments
--quota -q

Tamaño aprovisionado del recurso compartido, en gibibytes. Debe ser mayor que 0 y menor o igual que 5 TB (5120). Para recursos compartidos de archivos grandes, el tamaño máximo es 102400. En el caso de los recursos compartidos de archivos creados en Tipo de cuenta de Files Provisioned v2, consulte la respuesta de la API GetFileServiceUsage para obtener el tamaño de almacenamiento aprovisionado mínimo y máximo permitido.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--root-squash

Reducción de los derechos de acceso para el superusuario remoto. La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: AllSquash, NoRootSquash, RootSquash
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az storage share-rm delete

Elimine el recurso compartido de archivos de Azure especificado o la instantánea de recurso compartido.

Elimine el recurso compartido de archivos de Azure especificado o la instantánea de recurso compartido. CAMBIO IMPORTANTE: la instantánea no se puede eliminar de forma predeterminada y hemos agregado un nuevo parámetro que se usará si desea incluir sanpshots para la operación de eliminación.

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

Ejemplos

Elimine un recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount" (nombre de cuenta) en el grupo de recursos "MyResourceGroup".

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

Elimine un recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount" (identificador de cuenta).

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

Elimine un recurso compartido de archivos de Azure por identificador de recurso.

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

Elimine una instantánea de recurso compartido de archivos de Azure.

az storage share-rm delete --ids file-share-id --snapshot "2021-03-25T05:29:56.0000000Z"

Elimine un recurso compartido de archivos de Azure y todas sus instantáneas.

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

Elimine un recurso compartido de archivos de Azure y todas sus instantáneas (alquiladas o no emitidas).

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--account-name --storage-account

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--include

Optional. Los valores válidos son: instantáneas, instantáneas alquiladas, ninguna. El valor predeterminado no es ninguno. Para "instantáneas", el recurso compartido de archivos se elimina, incluidas todas sus instantáneas de recurso compartido de archivos. Si el recurso compartido de archivos contiene instantáneas alquiladas, se produce un error en la eliminación. En el caso de "instantáneas alquiladas", el recurso compartido de archivos se elimina incluido todas sus instantáneas de recurso compartido de archivos (concesionadas o sin versión). Para "none", el recurso compartido de archivos se elimina si no tiene instantáneas de recurso compartido. Si el recurso compartido de archivos contiene instantáneas (con concesión o sin publicación), se produce un error en la eliminación.

Propiedad Valor
Valor predeterminado: none
--name --share-name -n

Nombre del recurso compartido de archivos dentro de la cuenta de almacenamiento especificada. Los nombres de recursos compartidos de archivos deben tener entre 3 y 63 caracteres de longitud y usar números, letras minúsculas y guiones (-). Cada carácter de guión (-) debe ir precedido inmediatamente y seguido de una letra o número.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--snapshot

Opcional, se usa para eliminar una instantánea. Valor DateTime que especifica la instantánea de recurso compartido que se va a recuperar.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az storage share-rm exists

Compruebe la existencia de un recurso compartido de archivos de Azure.

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

Ejemplos

Compruebe la existencia de un recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount" (nombre de cuenta) en el grupo de recursos "MyResourceGroup".

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

Compruebe la existencia de un recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount" (identificador de cuenta).

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

Compruebe la existencia de un recurso compartido de archivos de Azure por identificador de recurso.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name -n

Nombre del recurso compartido de archivos.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--storage-account

Nombre o identificador de la cuenta de almacenamiento.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az storage share-rm list

Enumera todos los recursos compartidos.

az storage share-rm list --account-name --storage-account
                         [--filter]
                         [--include-deleted {0, 1, f, false, n, no, t, true, y, yes}]
                         [--include-snapshot {0, 1, f, false, n, no, t, true, y, yes}]
                         [--max-items]
                         [--maxpagesize]
                         [--next-token]
                         [--resource-group]

Ejemplos

Enumere los recursos compartidos de archivos de Azure en la cuenta de almacenamiento "mystorageaccount" (nombre de cuenta) en el grupo de recursos "MyResourceGroup".

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

Enumere los recursos compartidos de archivos de Azure en la cuenta de almacenamiento "mystorageaccount" (identificador de cuenta).

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

Enumere todos los recursos compartidos de archivos que se incluyen eliminados en la cuenta de almacenamiento "mystorageaccount".

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

Enumerar todos los recursos compartidos de archivos incluyen todas sus instantáneas en la cuenta de almacenamiento "mystorageaccount".

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

Enumerar todos los recursos compartidos de archivos incluyen todas sus instantáneas y recursos compartidos de archivos eliminados en la cuenta de almacenamiento "mystorageaccount".

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

Parámetros requeridos

--account-name --storage-account

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--filter

Optional. Cuando se especifica, solo se mostrarán los nombres de recurso compartido a partir del filtro.

--include-deleted

Incluya recursos compartidos de archivos eliminados temporalmente cuando se especifique.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--include-snapshot

Incluya instantáneas del recurso compartido de archivos cuando se especifique.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

Propiedad Valor
Grupo de parámetros: Pagination Arguments
--maxpagesize

Optional. Número máximo especificado de recursos compartidos que se pueden incluir en la lista.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Propiedad Valor
Grupo de parámetros: Pagination Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az storage share-rm restore

Restaure un recurso compartido de archivos dentro de los días de retención válidos si está habilitada la eliminación temporal del recurso compartido.

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

Ejemplos

Restaure un recurso compartido de archivos dentro de los días de retención válidos si está habilitada la eliminación temporal del recurso compartido.

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

Restaure un recurso compartido de archivos dentro de los días de retención válidos si la eliminación temporal del recurso compartido está habilitada para un nuevo nombre.

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

Parámetros requeridos

--deleted-version

Identifique la versión del recurso compartido eliminado que se restaurará.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name -n

Nombre del recurso compartido de archivos. Identifique el nombre del recurso compartido eliminado que se restaurará.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--restored-name

Nuevo nombre de recurso compartido de archivos que se va a restaurar. Si no se especifica, se usará el nombre del recurso compartido eliminado.

--storage-account

Nombre o identificador de la cuenta de almacenamiento.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az storage share-rm show

Muestra las propiedades de un recurso compartido de archivos de Azure o una instantánea de recurso compartido especificados.

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

Ejemplos

Muestre las propiedades de un recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount" (nombre de cuenta) en el grupo de recursos "MyResourceGroup".

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

Muestre las propiedades de un recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount" (identificador de cuenta).

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

Mostrar las propiedades de un recurso compartido de archivos de Azure por identificador de recurso.

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

Mostrar las propiedades de una instantánea de recurso compartido de archivos de Azure

az storage share-rm show --ids file-share-id --snapshot "2021-03-25T05:29:56.0000000Z"

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--account-name --storage-account

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--expand

Opcional, se usa para expandir las propiedades dentro de las propiedades del recurso compartido. Los valores válidos son: eliminados, instantáneas. Debe pasarse como una cadena con el delimitador ','.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name --share-name -n

Nombre del recurso compartido de archivos dentro de la cuenta de almacenamiento especificada. Los nombres de recursos compartidos de archivos deben tener entre 3 y 63 caracteres de longitud y usar números, letras minúsculas y guiones (-). Cada carácter de guión (-) debe ir precedido inmediatamente y seguido de una letra o número.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--snapshot

Opcional, se usa para eliminar una instantánea. Valor DateTime que especifica la instantánea de recurso compartido que se va a recuperar.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az storage share-rm snapshot

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree una instantánea de un recurso compartido existente en la cuenta especificada.

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

Ejemplos

Cree una instantánea de un recurso compartido existente en la cuenta especificada.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--access-tier

Nivel de acceso para un recurso compartido específico. La cuenta de GpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta FileStorage puede elegir Premium.

Propiedad Valor
Valores aceptados: Cool, Hot, Premium, TransactionOptimized
--enabled-protocols

Propiedad inmutable para el protocolo de recursos compartidos de archivos. El protocolo NFS solo estará disponible para recursos compartidos de archivos Premium (recursos compartidos de archivos en el tipo de cuenta FileStorage).

Propiedad Valor
Valores aceptados: NFS, SMB
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--metadata

Metadatos en pares clave=valor separados por espacios que están asociados al recurso compartido. Esto sobrescribe los metadatos existentes.

--name -n

Nombre del recurso compartido de archivos.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--quota -q

Tamaño máximo del recurso compartido en gigabytes. Debe ser mayor que 0 y menor o igual que 5 TB (5120). Para recursos compartidos de archivos grandes, el tamaño máximo es 102400.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--root-squash

Reducción de los derechos de acceso para el superusuario remoto.

Propiedad Valor
Valores aceptados: AllSquash, NoRootSquash, RootSquash
--storage-account

Nombre o identificador de la cuenta de almacenamiento.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az storage share-rm stats

obtiene los bytes de uso de los datos almacenados en el recurso compartido.

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

Ejemplos

obtiene los bytes de uso de los datos almacenados en el recurso compartido.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name -n

Nombre del recurso compartido de archivos.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--storage-account

Nombre o identificador de la cuenta de almacenamiento.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az storage share-rm update

Actualice un nuevo recurso compartido en la cuenta especificada como se describe en el cuerpo de la solicitud. El recurso compartido incluye metadatos y propiedades para ese recurso compartido. No incluye una lista de los archivos contenidos en el recurso compartido.

az storage share-rm update [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                           [--account-name --storage-account]
                           [--add]
                           [--bursting-max-mibps --paid-bursting-max-bandwidth-mibps]
                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                           [--ids]
                           [--metadata]
                           [--name --share-name]
                           [--paid-bursting-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                           [--paid-bursting-max-iops]
                           [--provisioned-bandwidth --provisioned-bandwidth-mibps]
                           [--provisioned-iops]
                           [--quota]
                           [--remove]
                           [--resource-group]
                           [--root-squash {AllSquash, NoRootSquash, RootSquash}]
                           [--set]
                           [--subscription]

Ejemplos

Actualice las propiedades de un recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount" (nombre de cuenta) en el grupo de recursos "MyResourceGroup".

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

Actualice las propiedades de un recurso compartido de archivos de Azure "myfileshare" en la cuenta de almacenamiento "mystorageaccount" (identificador de cuenta).

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

Actualice las propiedades de un recurso compartido de archivos de Azure por identificador de recurso.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--access-tier

Nivel de acceso para un recurso compartido específico. La cuenta de GpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta FileStorage puede elegir Premium.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Cool, Hot, Premium, TransactionOptimized
--account-name --storage-account

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--bursting-max-mibps --paid-bursting-max-bandwidth-mibps

Ancho de banda máximo de expansión de pago para el recurso compartido, en mebibytes por segundo. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files. El valor máximo permitido es 10340, que es el ancho de banda máximo permitido para un recurso compartido.

Propiedad Valor
Grupo de parámetros: Provisioned V1 Paid Bursting Arguments
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--metadata

Par nombre-valor que se va a asociar al recurso compartido como metadatos. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--name --share-name -n

Nombre del recurso compartido de archivos dentro de la cuenta de almacenamiento especificada. Los nombres de recursos compartidos de archivos deben tener entre 3 y 63 caracteres de longitud y usar números, letras minúsculas y guiones (-). Cada carácter de guión (-) debe ir precedido inmediatamente y seguido de una letra o número.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--paid-bursting-enabled

Indica si la expansión de pago está habilitada para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files.

Propiedad Valor
Grupo de parámetros: Provisioned V1 Paid Bursting Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--paid-bursting-max-iops

Número máximo de IOPS de expansión de pago para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files. El valor máximo permitido es 102400, que es el valor máximo permitido de IOPS para un recurso compartido.

Propiedad Valor
Grupo de parámetros: Provisioned V1 Paid Bursting Arguments
--provisioned-bandwidth --provisioned-bandwidth-mibps

Ancho de banda aprovisionado del recurso compartido, en mebibytes por segundo. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos. Consulte la respuesta de la API GetFileServiceUsage para obtener el valor mínimo y máximo permitido para el ancho de banda aprovisionado.

Propiedad Valor
Grupo de parámetros: Provisioned V2 Arguments
--provisioned-iops

IOPS aprovisionadas del recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos. Consulte la respuesta de la API GetFileServiceUsage para obtener el valor mínimo y máximo permitido para IOPS aprovisionadas.

Propiedad Valor
Grupo de parámetros: Provisioned V2 Arguments
--quota -q

Tamaño aprovisionado del recurso compartido, en gibibytes. Debe ser mayor que 0 y menor o igual que 5 TB (5120). Para recursos compartidos de archivos grandes, el tamaño máximo es 102400. En el caso de los recursos compartidos de archivos creados en Tipo de cuenta de Files Provisioned v2, consulte la respuesta de la API GetFileServiceUsage para obtener el tamaño de almacenamiento aprovisionado mínimo y máximo permitido.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--root-squash

Reducción de los derechos de acceso para el superusuario remoto. La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: AllSquash, NoRootSquash, RootSquash
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False