你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzRmStorageShare

参考

模块:: Az.Storage

创建存储文件共享。

语法

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

说明

New-AzRmStorageShare cmdlet 创建存储文件共享。

示例

示例 1：使用存储帐户名称和共享名称创建存储文件共享，元数据和共享配额为 100 GiB。

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

此命令创建包含元数据的存储文件共享，并将配额共享为 100 GiB。

示例 2：使用存储帐户对象创建存储文件共享

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

此命令使用存储帐户对象和共享名称创建存储文件共享。

示例 3：创建访问层为 Hot 的存储文件共享

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

此命令创建一个存储文件共享，其访问层为 Hot。

示例 4：创建现有共享的存储文件共享快照

$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

此命令创建现有基本文件共享的存储文件共享快照。

示例 5：使用 EnabledProtocol proeprty 作为 NFS 创建存储文件共享，将 RootSquash 属性创建为 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

此命令创建一个存储文件共享，将 EnabledProtocol proeprty 用作 NFS，将 RootSquash proeprty 创建为 NoRootSquash。

示例 6：使用预配带宽和 IOPS 创建存储文件共享

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

此命令创建具有预配带宽和 IOPS 的存储文件共享，它仅适用于文件预配 v2 帐户类型。

示例 7：创建具有付费突发带宽和 IOPS 的存储文件共享

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

此命令创建具有付费突发带宽和 IOPS 的存储文件共享，它仅适用于文件预配 v1 帐户类型。

参数

-AccessTier

特定共享的访问层。 StorageV2 帐户可以在 TransactionOptimized（默认）、热和冷之间进行选择。 FileStorage 帐户可以选择“高级”。

类型:	String
接受的值:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnabledProtocol

设置文件共享的协议。创建文件共享后，无法更改它。可能的值包括：“SMB”、“NFS”

类型:	String
接受的值:	NFS, SMB
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Metadata

共享元数据

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

Azure 文件共享名称

类型:	String
别名:	N, ShareName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PaidBurstingEnabled

指示是否为共享启用了付费突发。此属性仅适用于在文件预配 v1 SSD 帐户类型下创建的文件共享。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PaidBurstingMaxBandwidthMibps

共享的最大付费突发带宽（以每秒兆字节为单位）。此属性仅适用于在文件预配 v1 SSD 帐户类型下创建的文件共享。允许的最大值为 10340，这是共享允许的最大带宽。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PaidBurstingMaxIops

共享的最大付费突发 IOPS。此属性仅适用于在文件预配 v1 SSD 帐户类型下创建的文件共享。允许的最大值为 102400，这是共享允许的最大 IOPS。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProvisionedBandwidthMibps

共享的预配带宽（以每秒兆字节为单位）。此属性仅适用于在文件预配 v2 帐户类型下创建的文件共享。有关预配带宽的最小和允许值，请参阅 Get-AzStorageFileServiceUsage cmdlet 输出。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProvisionedIops

共享的预配 IOPS。此属性仅适用于在文件预配 v2 帐户类型下创建的文件共享。有关预配的 IOPS 的最小和最大允许值，请参阅 Get-AzStorageFileServiceUsage cmdlet 输出。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-QuotaGiB

在 Gibibyte 中共享配额。

类型:	Int32
别名:	Quota
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RootSquash

设置远程超级用户的访问权限减少。可能的值包括：“NoRootSquash”、“RootSquash”、“AllSquash”

类型:	String
接受的值:	NoRootSquash, RootSquash, AllSquash
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Snapshot

创建具有相同名称的现有共享的快照。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StorageAccount

存储帐户对象

类型:	PSStorageAccount
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-StorageAccountName

存储帐户名称。

类型:	String
别名:	AccountName
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

PSStorageAccount

输出

PSShare

通过