你当前正在访问 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>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      [-ResourceId] <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      -InputObject <PSShare>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

New-AzRm存储Share 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。

参数

-AccessTier

特定共享的访问层。存储V2 帐户可以选择 TransactionOptimized（默认值）、热帐户和冷帐户。文件存储帐户可以选择高级版。

Type:	String
Accepted values:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

存储 Share 对象

Type:	PSShare
Aliases:	Share
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Metadata

共享元数据

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

共享名

Type:	String
Aliases:	N, ShareName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-QuotaGiB

在 Gibibyte 中共享配额。

Type:	Int32
Aliases:	Quota
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

资源组名称。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

输入文件共享资源 ID。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RootSquash

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

Type:	String
Accepted values:	NoRootSquash, RootSquash, AllSquash
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccount

存储帐户对象

Type:	PSStorageAccount
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountName

存储帐户名称。

Type:	String
Aliases:	AccountName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

String

PSStorageAccount

PSShare

输出

PSShare

Update-AzRmStorageShare

语法

说明

示例

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

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

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

示例 4：使用 accesstier 作为 Cool 修改存储文件共享

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

参数

-AccessTier

-Confirm

-DefaultProfile

-InputObject

-Metadata

-Name

-QuotaGiB

-ResourceGroupName

-ResourceId

-RootSquash

-StorageAccount

-StorageAccountName

-WhatIf

输入

输出

反馈

其他资源

Update-AzRmStorageShare

语法

说明

示例

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

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

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

示例 4：使用 accesstier 作为 Cool 修改存储文件共享

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

参数

-AccessTier

-Confirm

-DefaultProfile

-InputObject

-Metadata

-Name

-QuotaGiB

-ResourceGroupName

-ResourceId

-RootSquash

-StorageAccount

-StorageAccountName

-WhatIf

输入

输出

反馈

其他资源

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

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