你当前正在访问 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>]
   [-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>]

说明

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。

参数

-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

-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

通过