Partager via


New-AzRmStorageShare

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>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-QuotaGiB <Int32>]
   [-Metadata <Hashtable>]
   [-AccessTier <String>]
   [-Snapshot]
   [-EnabledProtocol <String>]
   [-RootSquash <String>]
   [-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.

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 demande une confirmation 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

-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

Montre ce qui se passe en cas d’exécution de l’applet de commande. 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

Sorties

PSShare