Compartilhar via

New-AzRmStorageShare

  • Referência
Módulo:
Az.Storage

Cria um compartilhamento de arquivo de armazenamento.

Sintaxe

New-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -Name <String>
   [-QuotaGiB <Int32>]
   [-Metadata <Hashtable>]
   [-AccessTier <String>]
   [-Snapshot]
   [-EnabledProtocol <String>]
   [-RootSquash <String>]
   [-ProvisionedBandwidthMibps <Int32>]
   [-ProvisionedIops <Int32>]
   [-PaidBurstingEnabled]
   [-PaidBurstingMaxIops <Int32>]
   [-PaidBurstingMaxBandwidthMibps <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-QuotaGiB <Int32>]
   [-Metadata <Hashtable>]
   [-AccessTier <String>]
   [-Snapshot]
   [-EnabledProtocol <String>]
   [-RootSquash <String>]
   [-ProvisionedBandwidthMibps <Int32>]
   [-ProvisionedIops <Int32>]
   [-PaidBurstingEnabled]
   [-PaidBurstingMaxIops <Int32>]
   [-PaidBurstingMaxBandwidthMibps <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Exemplos

Exemplo 1: criar um compartilhamento de arquivos de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento, com metadados e cota de compartilhamento como 100 GiB.

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 100 -Metadata @{"tag1" = "value1"; "tag2" = "value2" }

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Esse comando cria um compartilhamento de arquivos de armazenamento com metadados e cota de compartilhamento como 100 GiB.

Exemplo 2: Criar um compartilhamento de arquivos de armazenamento com o objeto de conta de armazenamento

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | New-AzRmStorageShare -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Esse comando cria um compartilhamento de arquivos de armazenamento com o objeto de conta de armazenamento e o nome do compartilhamento.

Exemplo 3: criar um compartilhamento de arquivos de armazenamento com o accesstier como Hot

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Hot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Esse comando cria um compartilhamento de arquivos de armazenamento com o accesstier como Hot.

Exemplo 4: Criar um instantâneo de compartilhamento de arquivo de armazenamento de um compartilhamento existente

$shareSnapshot = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -Snapshot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes snapshotTime 
----     -------- ---------------- ---------- ------- ------- --------------- ------------   
myshare                                                                       2021-05-10T08:04:08

Esse comando cria um instantâneo de compartilhamento de arquivos de armazenamento de um compartilhamento de arquivo base existente.

Exemplo 5: Criar um compartilhamento de arquivos de armazenamento com a proeprty EnabledProtocol como NFS e a propriedade RootSquash como NoRootSquash

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -EnabledProtocol NFS -RootSquash NoRootSquash 

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.RootSquash
NoRootSquash

Esse comando cria um compartilhamento de arquivos de armazenamento com a proeprty EnabledProtocol como NFS e o rootSquash proeprty como NoRootSquash.

Exemplo 6: Criar 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 cria 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: Criar 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 cria 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.

Tipo:String
Valores aceitos:TransactionOptimized, Premium, Hot, Cool
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnabledProtocol

Define protocolos para compartilhamentos de arquivos. Ele não pode ser alterado após a criação do compartilhamento de arquivos. Os valores possíveis incluem: 'SMB', 'NFS'

Tipo:String
Valores aceitos:NFS, SMB
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Metadata

Compartilhar metadados

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Nome do compartilhamento de arquivos do Azure

Tipo:String
Aliases:N, ShareName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-QuotaGiB

Cota de compartilhamento em Gibibyte.

Tipo:Int32
Aliases:Quota
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Nome do Grupo de Recursos.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 aceitos:NoRootSquash, RootSquash, AllSquash
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Snapshot

Crie um instantâneo do compartilhamento existente com o mesmo nome.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageAccount

Objeto da conta de armazenamento

Tipo:PSStorageAccount
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StorageAccountName

Nome da conta de armazenamento.

Tipo:String
Aliases:AccountName
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Saídas