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
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
Partager des métadonnées
Type: Hashtable
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
(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 .
Sorties