Partager via

New-AzRmStorageShare

  • Référence
Module:
Az.Storage

Crée un partage de fichiers de stockage.

Syntaxe

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

L’applet de commande New-AzRmStorageShare crée un partage de fichiers de stockage.

Exemples

Exemple 1 : Créez un partage de fichiers de stockage avec le nom du compte de stockage et le nom du partage, avec des métadonnées et un quota de partage sous la forme de 100 Gio.

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

Cette commande crée un partage de fichiers de stockage avec des métadonnées et un quota de partage sous la forme de 100 Gio.

Exemple 2 : Créer un partage de fichiers de stockage avec l’objet compte de stockage

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Cette commande crée un partage de fichiers de stockage avec un objet de compte de stockage et un nom de partage.

Exemple 3 : Créer un partage de fichiers de stockage avec accesstier en tant que chaud

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Cette commande crée un partage de fichiers de stockage avec accesstier en tant que chaud.

Exemple 4 : Créer un instantané de partage de fichiers de stockage d’un partage existant

$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

Cette commande crée un instantané de partage de fichiers de stockage d’un partage de fichiers de base existant.

Exemple 5 : Créer un partage de fichiers de stockage avec le proeprty EnabledProtocol en tant que propriété NFS et RootSquash en tant que 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

Cette commande crée un partage de fichiers de stockage avec la proeprty EnabledProtocol en tant que NFS et rootSquash proeprty comme NoRootSquash.

Exemple 6 : Créer 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 crée un partage de fichiers de stockage avec bande passante provisionnée et IOPS, mais fonctionne uniquement sur le type de compte v2 provisionné de fichiers.

Exemple 7 : Créer un partage de fichiers de stockage avec bande passante en rafale payante et IOPS

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

Cette commande crée un partage de fichiers de stockage avec bande passante en rafale payante et IOPS, mais 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

-EnabledProtocol

Définit les protocoles pour les partages de fichiers. Il ne peut pas être modifié après la création du partage de fichiers. Les valeurs possibles sont les suivantes : « SMB », « NFS »

Type:String
Valeurs acceptées:NFS, SMB
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
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 de fichiers Azure

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:SwitchParameter
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

-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

-Snapshot

Créez un instantané de partage existant portant le même nom.

Type:SwitchParameter
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

Sorties