Update-AzRmStorageShare

Módulo:

Az.Storage Module

Modifica un recurso compartido de archivos de almacenamiento.

Sintaxis

AccountName (valor predeterminado)

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

El cmdlet New-AzRmStorageShare modifica un recurso compartido de archivos de Storage.

Ejemplos

Ejemplo 1: Modifica los metadatos de un recurso compartido de archivos de almacenamiento y la cuota de recursos compartidos con el nombre de la cuenta de almacenamiento y el nombre del recurso compartido

$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 los metadatos de un recurso compartido de archivos de Storage y la cuota de recursos compartidos con el nombre de la cuenta de almacenamiento y el nombre del recurso compartido, y muestra el resultado de modificación con el objeto de recurso compartido de archivos devuelto.

Ejemplo 2: Modifica los metadatos de un recurso compartido de archivos de almacenamiento con el objeto de cuenta de almacenamiento y el nombre del recurso compartido

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

Este comando modifica los metadatos de un recurso compartido de archivos de almacenamiento con el objeto de cuenta de almacenamiento y el nombre del recurso compartido.

Ejemplo 3: Modifica la cuota de recursos compartidos para todos los recursos compartidos de archivos de almacenamiento de una cuenta de almacenamiento con canalización

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 la cuota de recursos compartidos como 5000 GiB para todos los recursos compartidos de archivos de Storage de una cuenta de Storage con canalización.

Ejemplo 4: Modificar un recurso compartido de archivos de almacenamiento con accesstier como esporádico

$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 un recurso compartido de archivos de Storage con accesstier como Esporádico.

Ejemplo 5: Modifica rootquash para los recursos compartidos de archivos de una cuenta de almacenamiento

$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 la propiedad Share RootSquash a NoRootSquash. La propiedad RootSquash solo está disponible en el recurso compartido con EnabledProtocol como NFS.

Ejemplo 6: Modifica un recurso compartido de archivos de almacenamiento con ancho de banda aprovisionado e IOPS

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

Este comando modifica un recurso compartido de archivos de almacenamiento con ancho de banda aprovisionado e IOPS, solo funciona en el tipo de cuenta aprovisionado v2 de archivos.

Ejemplo 7: Modifica un recurso compartido de archivos de almacenamiento con ancho de banda de expansión de pago e IOPS

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

Este comando modifica un recurso compartido de archivos de almacenamiento con ancho de banda de expansión de pago e IOPS, solo funciona en el tipo de cuenta aprovisionado v1 de archivos.

Parámetros

-AccessTier

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

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Valores aceptados:	TransactionOptimized, Premium, Hot, Cool
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:	IAzureContextContainer
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-InputObject

Storage Share (objeto)

Propiedades de parámetro

Tipo:	PSShare
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Compartir

Conjuntos de parámetros

ShareObject

Posición:	Named
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Metadata

Compartir metadatos

Propiedades de parámetro

Tipo:	Hashtable
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Name

Nombre del recurso compartido

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	N, ShareName

Conjuntos de parámetros

AccountName

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

AccountObject

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-PaidBurstingEnabled

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.

Propiedades de parámetro

Tipo:	Boolean
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-PaidBurstingMaxBandwidthMibps

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.

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-PaidBurstingMaxIops

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.

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ProvisionedBandwidthMibps

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 salida del cmdlet Get-AzStorageFileServiceUsage para obtener el valor mínimo y máximo permitido para el ancho de banda aprovisionado.

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ProvisionedIops

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 salida del cmdlet Get-AzStorageFileServiceUsage para obtener el valor mínimo y máximo permitido para IOPS aprovisionadas.

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-QuotaGiB

Cuota de acciones en Gibibyte.

Propiedades de parámetro

Tipo:	Int32
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Quota

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

AccountName

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ResourceId

Escriba un identificador de recurso del recurso compartido de archivos.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ShareResourceId

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-RootSquash

Establece la reducción de los derechos de acceso para el superusuario remoto. Los valores posibles son: 'NoRootSquash', 'RootSquash', 'AllSquash'

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Valores aceptados:	NoRootSquash, RootSquash, AllSquash
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StorageAccount

Objeto de cuenta de almacenamiento

Propiedades de parámetro

Tipo:	PSStorageAccount
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

AccountObject

Posición:	Named
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StorageAccountName

Nombre de la cuenta de almacenamiento.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Nombre de la cuenta

Conjuntos de parámetros

AccountName

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

PSStorageAccount

PSShare

Salidas

PSShare