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

Description

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：建立記憶體檔案共用，且存取層為經常性存取

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Hot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare                            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

共用方式為