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

Description

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 修改為非經常性存取的記憶體檔案共用

$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：修改記憶體帳戶中檔案共用的 rootquash

$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

此命令會將 Share 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

共用的付費高載頻寬上限，每秒以 MB 為單位。 此屬性僅適用於在 [檔案布建 v1 SSD] 帳戶類型下建立的檔案共用。 允許的最大值是 10340，這是共用的最大允許頻寬。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PaidBurstingMaxIops

共用的付費高載 IOPS 上限。 此屬性僅適用於在 [檔案布建 v1 SSD] 帳戶類型下建立的檔案共用。 允許的最大值是 102400，這是共用允許的最大 IOPS。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ProvisionedBandwidthMibps

共用的布建頻寬，每秒以 MB 為單位。 此屬性僅適用於在 [檔案布建 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

輸入檔案共用資源標識碼。

類型:	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 執行時會發生什麼事。 指令未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

PSStorageAccount

PSShare

輸出

PSShare