Compartilhar via

az storage share-rm

Gerencie compartilhamentos de arquivos do Azure usando o provedor de recursos Microsoft.Storage.

Comandos

Nome Description Tipo Status
az storage share-rm create

Crie um novo compartilhamento na conta especificada, conforme descrito pelo corpo da solicitação. O recurso de compartilhamento inclui metadados e propriedades para esse compartilhamento. Ele não inclui uma lista dos arquivos contidos no compartilhamento.

 Core GA
az storage share-rm delete

Exclua o compartilhamento de arquivos ou o instantâneo de compartilhamento do Azure especificado.

 Core GA
az storage share-rm exists

Verifique a existência de um compartilhamento de arquivos do Azure.

 Core GA
az storage share-rm list

Listar todos os compartilhamentos.

 Core GA
az storage share-rm restore

Restaure um compartilhamento de arquivos dentro de um dia de retenção válido se a exclusão reversível de compartilhamento estiver habilitada.

 Core GA
az storage share-rm show

Mostre as propriedades de um compartilhamento de arquivos ou instantâneo de compartilhamento do Azure especificado.

 Core GA
az storage share-rm snapshot

Crie um instantâneo de um compartilhamento existente na conta especificada.

 Core Preview
az storage share-rm stats

obter os bytes de uso dos dados armazenados no compartilhamento.

 Core GA
az storage share-rm update

Atualize um novo compartilhamento na conta especificada, conforme descrito pelo corpo da solicitação. O recurso de compartilhamento inclui metadados e propriedades para esse compartilhamento. Ele não inclui uma lista dos arquivos contidos no compartilhamento.

 Core GA

az storage share-rm create

Editar

Crie um novo compartilhamento na conta especificada, conforme descrito pelo corpo da solicitação. O recurso de compartilhamento inclui metadados e propriedades para esse compartilhamento. Ele não inclui uma lista dos arquivos contidos no compartilhamento.

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}]

Exemplos

Crie um novo compartilhamento de arquivos do Azure 'myfileshare' com metadados e cota como 10 GB na conta de armazenamento 'mystorageaccount'(nome da conta) no grupo de recursos 'MyResourceGroup'.

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

Crie um novo compartilhamento de arquivos do Azure 'myfileshare' com metadados e cota como 6.000 GB na conta de armazenamento 'mystorageaccount'(nome da conta) que permite um grande compartilhamento de arquivos no 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

Crie um novo compartilhamento de arquivos do Azure 'myfileshare' com metadados e cota como 10 GB na conta de armazenamento 'mystorageaccount' (id da conta).

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

Crie um novo compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' que permite provisionarv2 no 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 Exigidos

--account-name --storage-account

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas.

--name --share-name -n

O nome do compartilhamento de arquivos dentro da conta de armazenamento especificada. Os nomes de compartilhamento de arquivo devem ter entre 3 e 63 caracteres de comprimento e usar números, letras minúsculas e traço (-). Cada caractere de traço (-) deve ser imediatamente precedido e seguido por uma letra ou número.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--access-tier

Camada de acesso para compartilhamento específico. A conta gpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: Cool, Hot, Premium, TransactionOptimized
--bursting-max-mibps --paid-bursting-max-bandwidth-mibps

A largura de banda máxima paga para o compartilhamento, em mebibytes por segundo. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta SSD Files Provisioned v1. O valor máximo permitido é 10340, que é a largura de banda máxima permitida para um compartilhamento.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
--enabled-protocols

O protocolo de autenticação usado para o compartilhamento de arquivos. O protocolo NFS só estará disponível para compartilhamentos de arquivos premium (compartilhamentos de arquivos no tipo de conta FileStorage). Só pode ser especificado ao criar um compartilhamento.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: NFS, SMB
--metadata

Um par nome-valor a ser associado ao compartilhamento como metadados. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--paid-bursting-enabled

Indica se o estouro pago está habilitado para o compartilhamento. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta SSD Files Provisioned v1.

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

O IOPS de intermitência máximo pago para o compartilhamento. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta SSD Files Provisioned v1. O valor máximo permitido é 102400, que é o IOPS máximo permitido para um compartilhamento.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
--provisioned-bandwidth --provisioned-bandwidth-mibps

A largura de banda provisionada do compartilhamento, em mebibytes por segundo. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta Files Provisioned v2. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para largura de banda provisionada.

Propriedade Valor
Grupo de parâmetros: Provisioned V2 Arguments
--provisioned-iops

O IOPS provisionado do compartilhamento. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta Files Provisioned v2. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para IOPS provisionado.

Propriedade Valor
Grupo de parâmetros: Provisioned V2 Arguments
--quota -q

O tamanho provisionado do compartilhamento, em gibibytes. Deve ser maior que 0 e menor ou igual a 5 TB (5120). Para Compartilhamentos de Arquivos Grandes, o tamanho máximo é 102400. Para compartilhamentos de arquivos criados em arquivos provisionados tipo de conta v2, consulte a resposta da API GetFileServiceUsage para o tamanho mínimo e máximo de armazenamento provisionado permitido.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--root-squash

Redução dos direitos de acesso para o superusuário remoto. A propriedade é somente para compartilhamento NFS. O padrão é NoRootSquash.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: AllSquash, NoRootSquash, RootSquash
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm delete

Editar

Exclua o compartilhamento de arquivos ou o instantâneo de compartilhamento do Azure especificado.

Exclua o compartilhamento de arquivos ou o instantâneo de compartilhamento do Azure especificado. MUDANÇA DE ÚLTIMA HORA: O instantâneo não pode ser excluído por padrão e adicionamos um novo parâmetro a ser usado se você quiser incluir sanpshots para a operação de exclusão.

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

Exemplos

Exclua um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

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

Exclua um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (id da conta).

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

Exclua um compartilhamento de arquivos do Azure por ID de recurso.

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

Exclua um instantâneo de compartilhamento de arquivos do Azure.

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

Exclua um compartilhamento de arquivos do Azure e todos os seus instantâneos.

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

Exclua um compartilhamento de arquivos do Azure e todos os seus instantâneos (concedidos/salvos).

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--account-name --storage-account

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--include

Optional. Os valores válidos são: instantâneos, instantâneos alugados, nenhum. O valor padrão é nenhum. Para 'instantâneos', o compartilhamento de arquivos é excluído, incluindo todos os instantâneos de compartilhamento de arquivos. Se o compartilhamento de arquivos contiver instantâneos concedidos, a exclusão falhará. Para 'leased-snapshots', o compartilhamento de arquivos é excluído incluído em todos os seus instantâneos de compartilhamento de arquivos (concedidos/salvos). Para 'none', o compartilhamento de arquivos será excluído se não tiver instantâneos de compartilhamento. Se o compartilhamento de arquivos contiver instantâneos (concedidos ou salvos), a exclusão falhará.

Propriedade Valor
Valor padrão: none
--name --share-name -n

O nome do compartilhamento de arquivos dentro da conta de armazenamento especificada. Os nomes de compartilhamento de arquivo devem ter entre 3 e 63 caracteres de comprimento e usar números, letras minúsculas e traço (-). Cada caractere de traço (-) deve ser imediatamente precedido e seguido por uma letra ou número.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--snapshot

Opcional, usado para excluir um instantâneo. O valor DateTime que especifica o instantâneo de compartilhamento a ser recuperado.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm exists

Editar

Verifique a existência de um compartilhamento de arquivos do Azure.

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

Exemplos

Verifique a existência de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

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

Verifique a existência de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (id da conta).

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

Verifique a existência de um compartilhamento de arquivos do Azure por ID de recurso.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do compartilhamento de arquivo.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--storage-account

O nome ou a ID da conta de armazenamento.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm list

Editar

Listar todos os compartilhamentos.

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]

Exemplos

Liste os compartilhamentos de arquivos do Azure na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

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

Liste os compartilhamentos de arquivos do Azure na conta de armazenamento 'mystorageaccount' (id da conta).

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

Listar todos os compartilhamentos de arquivos incluídos excluídos na conta de armazenamento 'mystorageaccount' .

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

Listar todos os compartilhamentos de arquivos incluindo todos os instantâneos na conta de armazenamento 'mystorageaccount'

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

Listar todos os compartilhamentos de arquivos incluem todos os instantâneos e compartilhamentos de arquivos excluídos na conta de armazenamento 'mystorageaccount'

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

Parâmetros Exigidos

--account-name --storage-account

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--filter

Optional. Quando especificado, somente os nomes de compartilhamento começando com o filtro serão listados.

--include-deleted

Inclua compartilhamentos de arquivos excluídos suavemente quando especificado.

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

Inclua instantâneos de compartilhamento de arquivo quando especificado.

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

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--maxpagesize

Optional. Número máximo especificado de compartilhamentos que podem ser incluídos na lista.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm restore

Editar

Restaure um compartilhamento de arquivos dentro de um dia de retenção válido se a exclusão reversível de compartilhamento estiver habilitada.

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

Exemplos

Restaure um compartilhamento de arquivos dentro de um dia de retenção válido se a exclusão reversível de compartilhamento estiver habilitada.

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

Restaure um compartilhamento de arquivos dentro de dias de retenção válidos se a exclusão reversível de compartilhamento estiver habilitada para um novo nome.

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

Parâmetros Exigidos

--deleted-version

Identifique a versão do compartilhamento excluído que será restaurado.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do compartilhamento de arquivo. Identifique o nome do compartilhamento excluído que será restaurado.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--restored-name

Um novo nome de compartilhamento de arquivo a ser restaurado. Se não for especificado, o nome do compartilhamento excluído será usado.

--storage-account

O nome ou a ID da conta de armazenamento.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm show

Editar

Mostre as propriedades de um compartilhamento de arquivos ou instantâneo de compartilhamento do Azure especificado.

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

Exemplos

Mostrar as propriedades de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

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

Mostrar as propriedades de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (id da conta).

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

Mostrar as propriedades de um compartilhamento de arquivos do Azure por ID de recurso.

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

Mostrar as propriedades de um instantâneo de compartilhamento de arquivos do Azure

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--account-name --storage-account

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--expand

Opcional, usado para expandir as propriedades dentro das propriedades do compartilhamento. Os valores válidos são: excluídos, instantâneos. Deve ser passado como uma cadeia de caracteres com delimitador ','.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name --share-name -n

O nome do compartilhamento de arquivos dentro da conta de armazenamento especificada. Os nomes de compartilhamento de arquivo devem ter entre 3 e 63 caracteres de comprimento e usar números, letras minúsculas e traço (-). Cada caractere de traço (-) deve ser imediatamente precedido e seguido por uma letra ou número.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--snapshot

Opcional, usado para excluir um instantâneo. O valor DateTime que especifica o instantâneo de compartilhamento a ser recuperado.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm snapshot

Editar
Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie um instantâneo de um compartilhamento existente na conta 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]

Exemplos

Crie um instantâneo de um compartilhamento existente na conta especificada.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--access-tier

Camada de acesso para compartilhamento específico. A conta gpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium.

Propriedade Valor
Valores aceitos: Cool, Hot, Premium, TransactionOptimized
--enabled-protocols

Propriedade imutável para o protocolo de compartilhamentos de arquivos. O protocolo NFS só estará disponível para compartilhamentos de arquivos premium (compartilhamentos de arquivos no tipo de conta FileStorage).

Propriedade Valor
Valores aceitos: NFS, SMB
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--metadata

Metadados em pares key=value separados por espaço associados ao compartilhamento. Isso substitui todos os metadados existentes.

--name -n

O nome do compartilhamento de arquivo.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--quota -q

O tamanho máximo do compartilhamento em gigabytes. Deve ser maior que 0 e menor ou igual a 5 TB (5120). Para Compartilhamentos de Arquivos Grandes, o tamanho máximo é 102400.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--root-squash

Redução dos direitos de acesso para o superusuário remoto.

Propriedade Valor
Valores aceitos: AllSquash, NoRootSquash, RootSquash
--storage-account

O nome ou a ID da conta de armazenamento.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm stats

Editar

obter os bytes de uso dos dados armazenados no compartilhamento.

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

Exemplos

obter os bytes de uso dos dados armazenados no compartilhamento.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do compartilhamento de arquivo.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--storage-account

O nome ou a ID da conta de armazenamento.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm update

Editar

Atualize um novo compartilhamento na conta especificada, conforme descrito pelo corpo da solicitação. O recurso de compartilhamento inclui metadados e propriedades para esse compartilhamento. Ele não inclui uma lista dos arquivos contidos no compartilhamento.

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]

Exemplos

Atualize as propriedades de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

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

Atualize as propriedades de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (id da conta).

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

Atualize as propriedades de um compartilhamento de arquivos do Azure por ID de recurso.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--access-tier

Camada de acesso para compartilhamento específico. A conta gpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: Cool, Hot, Premium, TransactionOptimized
--account-name --storage-account

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--bursting-max-mibps --paid-bursting-max-bandwidth-mibps

A largura de banda máxima paga para o compartilhamento, em mebibytes por segundo. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta SSD Files Provisioned v1. O valor máximo permitido é 10340, que é a largura de banda máxima permitida para um compartilhamento.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--metadata

Um par nome-valor a ser associado ao compartilhamento como metadados. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--name --share-name -n

O nome do compartilhamento de arquivos dentro da conta de armazenamento especificada. Os nomes de compartilhamento de arquivo devem ter entre 3 e 63 caracteres de comprimento e usar números, letras minúsculas e traço (-). Cada caractere de traço (-) deve ser imediatamente precedido e seguido por uma letra ou número.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--paid-bursting-enabled

Indica se o estouro pago está habilitado para o compartilhamento. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta SSD Files Provisioned v1.

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

O IOPS de intermitência máximo pago para o compartilhamento. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta SSD Files Provisioned v1. O valor máximo permitido é 102400, que é o IOPS máximo permitido para um compartilhamento.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
--provisioned-bandwidth --provisioned-bandwidth-mibps

A largura de banda provisionada do compartilhamento, em mebibytes por segundo. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta Files Provisioned v2. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para largura de banda provisionada.

Propriedade Valor
Grupo de parâmetros: Provisioned V2 Arguments
--provisioned-iops

O IOPS provisionado do compartilhamento. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta Files Provisioned v2. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para IOPS provisionado.

Propriedade Valor
Grupo de parâmetros: Provisioned V2 Arguments
--quota -q

O tamanho provisionado do compartilhamento, em gibibytes. Deve ser maior que 0 e menor ou igual a 5 TB (5120). Para Compartilhamentos de Arquivos Grandes, o tamanho máximo é 102400. Para compartilhamentos de arquivos criados em arquivos provisionados tipo de conta v2, consulte a resposta da API GetFileServiceUsage para o tamanho mínimo e máximo de armazenamento provisionado permitido.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--root-squash

Redução dos direitos de acesso para o superusuário remoto. A propriedade é somente para compartilhamento NFS. O padrão é NoRootSquash.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: AllSquash, NoRootSquash, RootSquash
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False