Bagikan melalui


New-AzRmStorageShare

Membuat berbagi file Storage.

Sintaks

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

Deskripsi

cmdlet New-AzRmStorageShare membuat berbagi file Storage.

Contoh

Contoh 1: Buat berbagi file Storage dengan nama akun Penyimpanan dan bagikan nama, dengan metadata dan bagikan kuota sebagai 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

Perintah ini membuat berbagi file Storage dengan metadata dan berbagi kuota sebagai 100 GiB.

Contoh 2: Membuat berbagi file Storage dengan objek akun Storage

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | New-AzRmStorageShare -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocol AccessTier Deleted Version ShareUsageBytes
----     -------- --------------- ---------- ------- ------- ---------------
myshare

Perintah ini membuat berbagi file Storage dengan objek akun Storage dan berbagi nama.

Contoh 3: Membuat berbagi file Storage dengan accesstier sebagai Hot

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Perintah ini membuat berbagi file Storage dengan accesstier sebagai Hot.

Contoh 4: Membuat rekam jepret berbagi file Penyimpanan dari berbagi yang sudah ada

$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

Perintah ini membuat rekam jepret berbagi file Penyimpanan dari berbagi file dasar yang ada.

Contoh 5: Membuat berbagi file Storage dengan proeprty EnabledProtocol sebagai NFS, dan properti RootSquash sebagai 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

Perintah ini membuat berbagi file Storage dengan EnabledProtocol proeprty sebagai NFS, dan rootSquash proeprty sebagai NoRootSquash.

Contoh 6: Membuat berbagi file Storage dengan bandwidth dan IOPS yang disediakan

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -ProvisionedBandwidthMibps 129 -ProvisionedIops 3032

Perintah ini membuat berbagi file Penyimpanan dengan bandwidth dan IOPS yang disediakan, hanya berfungsi pada jenis akun Files Provisioned v2.

Contoh 7: Membuat berbagi file Storage dengan bandwidth bursting berbayar dan IOPS

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -PaidBurstingEnabled -PaidBurstingMaxBandwidthMibps 129 -PaidBurstingMaxIops 3032

Perintah ini membuat berbagi file Penyimpanan dengan bandwidth bursting berbayar dan IOPS, hanya berfungsi pada jenis akun Files Provisioned v1.

Parameter

-AccessTier

Tingkat akses untuk berbagi tertentu. Akun StorageV2 dapat memilih antara TransactionOptimized (default), Hot, dan Cool. Akun FileStorage dapat memilih Premium.

Jenis:String
Nilai yang diterima:TransactionOptimized, Premium, Hot, Cool
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-EnabledProtocol

Mengatur protokol untuk berbagi file. Ini tidak dapat diubah setelah pembuatan berbagi file. Nilai yang mungkin termasuk: 'SMB', 'NFS'

Jenis:String
Nilai yang diterima:NFS, SMB
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Metadata

Bagi Metadata

Jenis:Hashtable
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Name

Nama berbagi File Azure

Jenis:String
Alias:N, ShareName
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-PaidBurstingEnabled

Menunjukkan apakah bursting berbayar diaktifkan untuk berbagi. Properti ini hanya untuk berbagi file yang dibuat di bawah Jenis akun SSD Files Provisioned v1.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PaidBurstingMaxBandwidthMibps

Bandwidth bursting berbayar maksimum untuk berbagi, dalam mebibyte per detik. Properti ini hanya untuk berbagi file yang dibuat di bawah Jenis akun SSD Files Provisioned v1. Nilai maksimum yang diizinkan adalah 10340 yang merupakan bandwidth maksimum yang diizinkan untuk berbagi.

Jenis:Int32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PaidBurstingMaxIops

IOPS bursting berbayar maksimum untuk berbagi. Properti ini hanya untuk berbagi file yang dibuat di bawah Jenis akun SSD Files Provisioned v1. Nilai maksimum yang diizinkan adalah 102400 yang merupakan IOPS maksimum yang diizinkan untuk berbagi.

Jenis:Int32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProvisionedBandwidthMibps

Bandwidth berbagi yang disediakan, dalam mebibyte per detik. Properti ini hanya untuk berbagi file yang dibuat di bawah Jenis akun Files Provisioned v2. Silakan lihat output cmdlet Get-AzStorageFileServiceUsage untuk nilai minimum dan maksimum yang diizinkan untuk bandwidth yang disediakan.

Jenis:Int32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ProvisionedIops

IOPS berbagi yang disediakan. Properti ini hanya untuk berbagi file yang dibuat di bawah Jenis akun Files Provisioned v2. Silakan lihat output cmdlet Get-AzStorageFileServiceUsage untuk nilai minimum dan maksimum yang diizinkan untuk IOPS yang disediakan.

Jenis:Int32
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-QuotaGiB

Bagi Kuota di Gibibyte.

Jenis:Int32
Alias:Quota
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ResourceGroupName

Nama Grup Sumber Daya.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-RootSquash

Mengatur pengurangan hak akses untuk superuser jarak jauh. Nilai yang mungkin termasuk: 'NoRootSquash', 'RootSquash', 'AllSquash'

Jenis:String
Nilai yang diterima:NoRootSquash, RootSquash, AllSquash
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Snapshot

Buat rekam jepret berbagi yang ada dengan nama yang sama.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-StorageAccount

Objek akun penyimpanan

Jenis:PSStorageAccount
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-StorageAccountName

Nama Akun Penyimpanan.

Jenis:String
Alias:AccountName
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

Output