共用方式為

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

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。

參數

-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

-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 執行時會發生什麼事。 Cmdlet 未執行。

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

輸入

String

PSStorageAccount

PSShare

輸出

PSShare