Update-AzRmStorageShare

Référence

Module:: Az.Storage

Modifie un partage de fichiers de stockage.

Syntaxe

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

L’applet de commande New-AzRmStorageShare modifie un partage de fichiers de stockage.

Exemples

Exemple 1 : modifie les métadonnées d’un partage de fichiers de stockage et le quota de partage avec le nom du compte de stockage et le nom du partage

$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

Cette commande modifie les métadonnées d’un partage de fichiers de stockage et le quota de partage avec le nom du compte de stockage et le nom du partage, et affiche le résultat de modification avec l’objet de partage de fichiers retourné.

Exemple 2 : Modifie les métadonnées sur un partage de fichiers de stockage avec l’objet de compte de stockage et le nom du partage

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

Cette commande modifie les métadonnées sur un partage de fichiers de stockage avec l’objet de compte de stockage et le nom du partage.

Exemple 3 : modifie le quota de partage pour tous les partages de fichiers de stockage dans un compte de stockage avec 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

Cette commande modifie le quota de partage en tant que 5 000 Gio pour tous les partages de fichiers de stockage dans un compte de stockage avec pipeline.

Exemple 4 : Modifier un partage de fichiers de stockage avec accesstier comme froid

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Cette commande modifie un partage de fichiers de stockage avec accesstier comme Cool.

Exemple 5 : Modifie rootquash pour un partage de fichiers dans un compte de stockage

$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

Cette commande modifie la propriété RootSquash en NoRootSquash. La propriété RootSquash n’est qu’avaialbe sur le partage avec EnabledProtocol en tant que NFS.

Exemple 6 : modifie un partage de fichiers de stockage avec bande passante provisionnée et IOPS

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

Cette commande modifie un partage de fichiers de stockage avec bande passante provisionnée et IOPS, elle fonctionne uniquement sur le type de compte v2 provisionné de fichiers.

Exemple 7 : modifie un partage de fichiers de stockage avec bande passante de rafale payante et IOPS

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

Cette commande modifie un partage de fichiers de stockage avec une bande passante de rafale payante et des E/S par seconde, elle fonctionne uniquement sur le type de compte v1 provisionné de fichiers.

Paramètres

-AccessTier

Niveau d’accès pour un partage spécifique. Le compte StorageV2 peut choisir entre TransactionOptimized (valeur par défaut), Chaud et Froid. Le compte FileStorage peut choisir Premium.

Type:	String
Valeurs acceptées:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Objet De partage de stockage

Type:	PSShare
Alias:	Share
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Metadata

Partager des métadonnées

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Name

Nom du partage

Type:	String
Alias:	N, ShareName
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PaidBurstingEnabled

Indique si le bursting payant est activé pour le partage. Cette propriété concerne uniquement les partages de fichiers créés sous le type de compte SSD v1 provisionné de fichiers.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PaidBurstingMaxBandwidthMibps

Bande passante de rafale payante maximale pour le partage, en mebibytes par seconde. Cette propriété concerne uniquement les partages de fichiers créés sous le type de compte SSD v1 provisionné de fichiers. La valeur maximale autorisée est 10340, c’est-à-dire la bande passante maximale autorisée pour un partage.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PaidBurstingMaxIops

Nombre maximal d’E/S par seconde d’E/S par seconde payantes pour le partage. Cette propriété concerne uniquement les partages de fichiers créés sous le type de compte SSD v1 provisionné de fichiers. La valeur maximale autorisée est 102400, c’est-à-dire le nombre maximal d’IOPS autorisés pour un partage.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ProvisionedBandwidthMibps

Bande passante provisionnée du partage, en mebibytes par seconde. Cette propriété est uniquement destinée aux partages de fichiers créés sous le type de compte v2 provisionné de fichiers. Reportez-vous à la sortie de l’applet de commande Get-AzStorageFileServiceUsage pour la valeur minimale et maximale autorisée pour la bande passante provisionnée.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ProvisionedIops

IOPS provisionné du partage. Cette propriété est uniquement destinée aux partages de fichiers créés sous le type de compte v2 provisionné de fichiers. Reportez-vous à la sortie de l’applet de commande Get-AzStorageFileServiceUsage pour la valeur minimale et maximale autorisée pour les E/S par seconde approvisionnées.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-QuotaGiB

Partager le quota dans Gibibyte.

Type:	Int32
Alias:	Quota
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceGroupName

Nom du groupe de ressources.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceId

Entrez un ID de ressource de partage de fichiers.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-RootSquash

Définit la réduction des droits d’accès pour le superutilisateur distant. Les valeurs possibles sont les suivantes : « NoRootSquash », « RootSquash », « AllSquash »

Type:	String
Valeurs acceptées:	NoRootSquash, RootSquash, AllSquash
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-StorageAccount

Objet compte de stockage

Type:	PSStorageAccount
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-StorageAccountName

Nom du compte de stockage.

Type:	String
Alias:	AccountName
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

PSStorageAccount

PSShare

Sorties