Update-AzRmStorageShare

Referência

Módulo:: Az.Storage

Modifica um compartilhamento de arquivos de armazenamento.

Sintaxe

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

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

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

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 de um compartilhamento de arquivos de armazenamento e a cota de compartilhamento 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

Este 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 arquivos 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"}

Este 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

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

Este comando modifica um compartilhamento de arquivos de armazenamento com 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

Este comando modifica a propriedade share RootSquash para NoRootSquash. A propriedade RootSquash só está disponível em 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

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

Exemplo 7: Modifica um compartilhamento de arquivos de armazenamento com largura de banda bursting paga e IOPS

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

Este comando modifica um compartilhamento de arquivos de armazenamento com largura de banda de bursting paga e IOPS, ele só funciona no tipo de conta Files Provisioned 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.

Tipo:	String
Valores aceites:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InputObject

Objeto de compartilhamento de armazenamento

Tipo:	PSShare
Aliases:	Share
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Metadata

Partilhar metadados

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Nome da Partilha

Tipo:	String
Aliases:	N, ShareName
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PaidBurstingEnabled

Indica se o bursting pago está habilitado para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v1 SSD tipo de conta.

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PaidBurstingMaxBandwidthMibps

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

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PaidBurstingMaxIops

O máximo pago de IOPS bursting para a ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v1 SSD tipo de conta. O valor máximo permitido é 102400, que é o máximo permitido IOPS para uma ação.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ProvisionedBandwidthMibps

A largura de banda provisionada do compartilhamento, em mebibytes por segundo. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a saída do cmdlet Get-AzStorageFileServiceUsage para obter o valor mínimo e máximo permitido para largura de banda provisionada.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ProvisionedIops

O IOPS provisionado da ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a saída do cmdlet Get-AzStorageFileServiceUsage para obter o valor mínimo e máximo permitido para IOPS provisionadas.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-QuotaGiB

Compartilhar cota em Gibibyte.

Tipo:	Int32
Aliases:	Quota
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceGroupName

Nome do Grupo de Recursos.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceId

Insira uma ID de recurso de compartilhamento de arquivos.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-RootSquash

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

Tipo:	String
Valores aceites:	NoRootSquash, RootSquash, AllSquash
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-StorageAccount

Objeto da conta de armazenamento

Tipo:	PSStorageAccount
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-StorageAccountName

Nome da conta de armazenamento.

Tipo:	String
Aliases:	AccountName
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

String

PSStorageAccount

PSShare

Saídas