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

New-AzRmStorageShare

模块:: Az.Storage Module

创建存储文件共享。

语法

AccountName （默认值）

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

说明

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 属性创建存储文件共享作为 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 属性为 NFS，将 RootSquash 属性创建为 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
默认值:	None
接受的值:	TransactionOptimized, Premium, Hot, Cool
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EnabledProtocol

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

参数属性

类型:	String
默认值:	None
接受的值:	NFS, SMB
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Metadata

共享元数据

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

Azure 文件共享名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	N, ShareName

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PaidBurstingEnabled

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PaidBurstingMaxBandwidthMibps

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PaidBurstingMaxIops

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ProvisionedBandwidthMibps

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ProvisionedIops

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-QuotaGiB

在 Gibibyte 中共享配额。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False
别名:	Quota

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

资源组名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

AccountName

Position:	0
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RootSquash

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

参数属性

类型:	String
默认值:	None
接受的值:	NoRootSquash, RootSquash, AllSquash
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Snapshot

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-StorageAccount

存储帐户对象

参数属性

类型:	PSStorageAccount
默认值:	None
支持通配符:	False
不显示:	False

参数集

AccountObject

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-StorageAccountName

存储帐户名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	账户名称

参数集

AccountName

Position:	1
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

New-AzRmStorageShare

语法

AccountName （默认值）

AccountObject

说明

示例

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

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

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

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

示例 5：使用 EnabledProtocol 属性创建存储文件共享作为 NFS，将 RootSquash 属性创建为 NoRootSquash

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

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

参数

-AccessTier

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-EnabledProtocol

参数属性

参数集

-Metadata

参数属性

参数集

-Name

参数属性

参数集

-PaidBurstingEnabled

参数属性

参数集

-PaidBurstingMaxBandwidthMibps

参数属性

参数集

-PaidBurstingMaxIops

参数属性

参数集

-ProvisionedBandwidthMibps

参数属性

参数集

-ProvisionedIops

参数属性

参数集

-QuotaGiB

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-RootSquash

参数属性

参数集

-Snapshot

参数属性

参数集

-StorageAccount

参数属性

参数集

-StorageAccountName

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

String

PSStorageAccount

输出

PSShare

反馈