New-AzRmStorageShare

模組:: Az.Storage Module

建立儲存體檔案共用。

語法

AccountName (預設值)

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

AccountObject

New-AzRmStorageShare
    -StorageAccount <PSStorageAccount>
    -Name <String>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-Snapshot]
    [-EnabledProtocol <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-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：建立儲存體檔案共用，並將 accesstier 設為熱

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

此命令會建立儲存體檔案共用，並將 accesstier 設為 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 屬性作為 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 屬性會做為 NFS，並將 RootSquash 屬性會做為 NoRootSquash。

範例 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 （預設）、Hot 和 Cool 之間進行選擇。 FileStorage 帳戶可以選擇 [進階]。

參數屬性

類型:	String
預設值:	None
接受的值:	TransactionOptimized, Premium, Hot, Cool
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EnabledProtocol

設定檔案共用的通訊協定。建立檔案共用後無法變更。可能的值包括：「SMB」、「NFS」

參數屬性

類型:	String
預設值:	None
接受的值:	NFS, SMB
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Metadata

共用中繼資料

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

Azure 檔案共用名稱

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	N, ShareName

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PaidBurstingEnabled

指出是否為共用啟用付費高載。此屬性僅適用於在 [檔案布建 v1 SSD] 帳戶類型下建立的檔案共用。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PaidBurstingMaxBandwidthMibps

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

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PaidBurstingMaxIops

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

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ProvisionedBandwidthMibps

共用的布建頻寬，每秒以 MB 為單位。此屬性僅適用於在 [檔案布建 v2] 帳戶類型下建立的檔案共用。請參閱 Get-AzStorageFileServiceUsage Cmdlet 輸出，以取得佈建頻寬允許的最小值和最大值。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ProvisionedIops

共用的已布建 IOPS。此屬性僅適用於在 [檔案布建 v2] 帳戶類型下建立的檔案共用。請參閱 Get-AzStorageFileServiceUsage Cmdlet 輸出，以取得佈建 IOPS 的最小和最大允許值。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-QuotaGiB

以 Gibibyte 為單位的共享配額。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	Quota

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceGroupName

資源組名。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AccountName

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RootSquash

設定遠端超級使用者的存取權限減少。可能的值包括：「NoRootSquash」、「RootSquash」、「AllSquash」

參數屬性

類型:	String
預設值:	None
接受的值:	NoRootSquash, RootSquash, AllSquash
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Snapshot

建立具有相同名稱的現有共用快照集。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageAccount

儲存體帳戶物件

參數屬性

類型:	PSStorageAccount
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AccountObject

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageAccountName

儲存體帳戶名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	帳戶名稱

參數集

AccountName

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

共用方式為

New-AzRmStorageShare

語法

AccountName (預設值)

AccountObject

Description

範例

範例 1：使用儲存體帳戶名稱和共用名稱建立儲存體檔案共用，並將中繼資料和共用配額設為 100 GiB。

範例 2：使用儲存體帳戶物件建立儲存體檔案共用

範例 3：建立儲存體檔案共用，並將 accesstier 設為熱

範例 4：建立現有共用的儲存體檔案共用快照集

範例 5：建立儲存體檔案共用，並將 EnabledProtocol 屬性作為 NFS，並將 RootSquash 屬性作為 NoRootSquash

範例 6：建立具有佈建頻寬和 IOPS 的儲存體檔案共用

範例 7：建立具有付費高載頻寬和 IOPS 的儲存體檔案共用

參數

-AccessTier

參數屬性

參數集

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-EnabledProtocol

參數屬性

參數集

-Metadata

參數屬性

參數集

-Name

參數屬性

參數集

-PaidBurstingEnabled

參數屬性

參數集

-PaidBurstingMaxBandwidthMibps

參數屬性

參數集

-PaidBurstingMaxIops

參數屬性

參數集

-ProvisionedBandwidthMibps

參數屬性

參數集

-ProvisionedIops

參數屬性

參數集

-QuotaGiB

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-RootSquash

參數屬性

參數集

-Snapshot

參數屬性

參數集

-StorageAccount

參數屬性

參數集

-StorageAccountName

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

String

PSStorageAccount

輸出

PSShare

意見反應