Partager via


New-AzRmStorageShare

Crée un partage de fichiers de stockage.

Syntaxe

AccountName (Par défaut)

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

AccountObject

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 la propriété EnabledProtocol en tant que propriété NFS et RootSquash comme 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 propriété EnabledProtocol en tant que propriété NFS et RootSquash 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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:TransactionOptimized, Premium, Hot, Cool
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 »

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:NFS, SMB
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Metadata

Partager des métadonnées

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Nom du partage de fichiers Azure

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:N, ShareName

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-QuotaGiB

Partager le quota dans Gibibyte.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Quota

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AccountName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 »

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:NoRootSquash, RootSquash, AllSquash
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Snapshot

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageAccount

Objet compte de stockage

Propriétés du paramètre

Type:PSStorageAccount
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AccountObject
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageAccountName

Nom du compte de stockage.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Nom du compte

Jeux de paramètres

AccountName
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

PSStorageAccount

Sorties

PSShare