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

Update-AzRmStorageShare

参考

模块:: Az.Storage

修改存储文件共享。

语法

Update-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      [-ResourceId] <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      -InputObject <PSShare>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

New-AzRmStorageShare cmdlet 修改存储文件共享。

示例

示例 1：使用存储帐户名称和共享名称修改存储文件共享的元数据和共享配额

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 200 -Metadata @{tag0="value0";tag1="value1"}

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.Metadata

Key  Value  
---  ----- 
tag0 value0
tag1 value1

此命令使用存储帐户名称和共享名称修改存储文件共享的元数据和共享配额，并使用返回的文件共享对象显示修改结果。

示例 2：使用存储帐户对象和共享名称修改存储文件共享上的元数据

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
$share = Update-AzRmStorageShare -StorageAccount $accountObject -Name "myshare" -Metadata @{tag0="value0";tag1="value1"}

此命令使用存储帐户对象和共享名称修改存储文件共享上的元数据。

示例 3：使用管道修改存储帐户中所有存储文件共享的共享配额

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Update-AzRmStorageShare -QuotaGiB 5000

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
share1   5000
share2   5000

此命令使用管道将存储帐户中所有存储文件共享的共享配额修改为 5000 GiB。

示例 4：将 accesstier 修改为 Cool 的存储文件共享

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Cool

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

此命令将存储文件共享修改为冷访问器。

示例 5：修改存储帐户中文件共享的根库

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -RootSquash NoRootSquash 

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.RootSquash
NoRootSquash

此命令将共享 RootSquash 属性修改为 NoRootSquash。 RootSquash 属性仅在与 EnabledProtocol 作为 NFS 共享时使用 avaialbe。

示例 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

-InputObject

Storage Share 对象

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

-Metadata

共享元数据

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

-Name

共享名称

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

-PaidBurstingEnabled

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

类型:	Boolean
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

-ResourceId

输入文件共享资源 ID。

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

-RootSquash

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

类型:	String
接受的值:	NoRootSquash, RootSquash, AllSquash
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

输出