Update-AzRmStorageShare

Módulo:
Az.Storage Module

Modifica um compartilhamento de arquivos de armazenamento.

Sintaxe

AccountName (Default) 

Update-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -Name <String>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled <Boolean>]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountObject 

Update-AzRmStorageShare
    -Name <String>
    -StorageAccount <PSStorageAccount>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled <Boolean>]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ShareResourceId 

Update-AzRmStorageShare
    [-ResourceId] <String>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled <Boolean>]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ShareObject 

Update-AzRmStorageShare
    -InputObject <PSShare>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled <Boolean>]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet New-AzRmStorageShare modifica um compartilhamento de arquivos de armazenamento.

Exemplos

Exemplo 1: modifica os metadados e a cota de compartilhamento de um compartilhamento de arquivo de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 200 -Metadata @{tag0="value0";tag1="value1"}

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  200

$share.Metadata

Key  Value
---  -----
tag0 value0
tag1 value1

Esse comando modifica os metadados e a cota de compartilhamento de um compartilhamento de arquivos de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento e mostra o resultado da modificação com o objeto de compartilhamento de arquivo retornado.

Exemplo 2: modifica metadados em um compartilhamento de arquivos de armazenamento com o objeto de conta de armazenamento e o nome do compartilhamento

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
$share = Update-AzRmStorageShare -StorageAccount $accountObject -Name "myshare" -Metadata @{tag0="value0";tag1="value1"}

Esse comando modifica metadados em um compartilhamento de arquivos de armazenamento com o objeto de conta de armazenamento e o nome do compartilhamento.

Exemplo 3: modifica a cota de compartilhamento para todos os compartilhamentos de arquivos de armazenamento em uma conta de Armazenamento com pipeline

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Update-AzRmStorageShare -QuotaGiB 5000

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
share1   5000
share2   5000

Esse comando modifica a cota de compartilhamento como 5000 GiB para todos os compartilhamentos de arquivos de armazenamento em uma conta de Armazenamento com pipeline.

Exemplo 4: modificar um compartilhamento de arquivos de armazenamento com o accesstier como Cool

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Cool

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare                            Cool

Esse comando modifica um compartilhamento de arquivos de armazenamento com o accesstier como Cool.

Exemplo 5: modifica rootsquash para compartilhamentos de arquivos em uma conta de Armazenamento

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -RootSquash NoRootSquash

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare

$share.RootSquash
NoRootSquash

Esse comando modifica o compartilhamento da propriedade RootSquash para NoRootSquash. A propriedade RootSquash só está disponível no compartilhamento com EnabledProtocol como NFS.

Exemplo 6: modifica um compartilhamento de arquivos de armazenamento com largura de banda provisionada e IOPS

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -ProvisionedBandwidthMibps 129 -ProvisionedIops 3032

Esse comando modifica um compartilhamento de arquivos de armazenamento com largura de banda provisionada e IOPS, ele só funciona no tipo de conta De arquivos provisionados v2.

Exemplo 7: modifica um compartilhamento de arquivos de armazenamento com largura de banda de intermitência paga e IOPS

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -PaidBurstingEnabled -PaidBurstingMaxBandwidthMibps 129 -PaidBurstingMaxIops 3032

Esse comando modifica um compartilhamento de arquivos de armazenamento com largura de banda de intermitência paga e IOPS, ele só funciona no tipo de conta De arquivos provisionados v1.

Parâmetros

-AccessTier

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:TransactionOptimized, Premium, Hot, Cool
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

Objeto Compartilhamento de Armazenamento

Propriedades do parâmetro

Tipo:PSShare
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Share

Conjuntos de parâmetros

ShareObject
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Metadata

Compartilhar metadados

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Nome do Compartilhamento

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:N, ShareName

Conjuntos de parâmetros

AccountName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
AccountObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PaidBurstingEnabled

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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PaidBurstingMaxBandwidthMibps

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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PaidBurstingMaxIops

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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProvisionedBandwidthMibps

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 saída de cmdlet Get-AzStorageFileServiceUsage para o valor mínimo e máximo permitido para largura de banda provisionada.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProvisionedIops

O IOPS provisionado do compartilhamento. Essa propriedade é apenas para compartilhamentos de arquivos criados no tipo de conta Files Provisioned v2. Consulte a saída do cmdlet Get-AzStorageFileServiceUsage para o valor mínimo e máximo permitido para IOPS provisionado.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-QuotaGiB

Cota de compartilhamento em Gibibyte.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Cota

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

Nome do Grupo de Recursos.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccountName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceId

Insira uma ID de recurso de compartilhamento de arquivo.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ShareResourceId
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RootSquash

Define a redução dos direitos de acesso para o superusuário remoto. Os valores possíveis incluem: 'NoRootSquash', 'RootSquash', 'AllSquash'

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:NoRootSquash, RootSquash, AllSquash
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageAccount

Objeto da conta de armazenamento

Propriedades do parâmetro

Tipo:PSStorageAccount
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AccountObject
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageAccountName

Nome da conta de armazenamento.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Nome da Conta

Conjuntos de parâmetros

AccountName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

PSStorageAccount

PSShare

Saídas

PSShare