New-AzRmStorageShare

Referens

Modul:: Az.Storage

Skapar en lagringsfilresurs.

Syntax

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

Description

Cmdleten New-AzRmStorageShare skapar en lagringsfilresurs.

Exempel

Exempel 1: Skapa en lagringsfilresurs med lagringskontots namn och resursnamn, med metadata och resurskvot som 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

Det här kommandot skapar en lagringsfilresurs med metadata och resurskvot som 100 GiB.

Exempel 2: Skapa en lagringsfilresurs med lagringskontoobjekt

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Det här kommandot skapar en lagringsfilresurs med lagringskontoobjektet och resursnamnet.

Exempel 3: Skapa en lagringsfilresurs med accesstier som Frekvent

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Det här kommandot skapar en lagringsfilresurs med åtkomsttier som Frekvent.

Exempel 4: Skapa en ögonblicksbild av en lagringsfilresurs av en befintlig resurs

$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

Det här kommandot skapar en ögonblicksbild av en lagringsfilresurs av en befintlig basfilresurs.

Exempel 5: Skapa en lagringsfilresurs med EnabledProtocol proeprty som NFS och egenskapen RootSquash som 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

Det här kommandot skapar en lagringsfilresurs med EnabledProtocol proeprty som NFS och RootSquash proeprty som NoRootSquash.

Exempel 6: Skapa en lagringsfilresurs med etablerad bandbredd och IOPS

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

Det här kommandot skapar en lagringsfilresurs med etablerad bandbredd och IOPS. Det fungerar bara med kontotypen Files Provisioned v2.

Exempel 7: Skapa en lagringsfilresurs med betald bandbredd och IOPS

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

Det här kommandot skapar en lagringsfilresurs med betald bandbredd och IOPS. Det fungerar bara med kontotypen Files Provisioned v1.

Parametrar

-AccessTier

Åtkomstnivå för specifik resurs. StorageV2-kontot kan välja mellan TransactionOptimized (standard), Frekvent och Lågfrekvent. FileStorage-kontot kan välja Premium.

Typ:	String
Godkända värden:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EnabledProtocol

Anger protokoll för filresurser. Det går inte att ändra den när filresursen har skapats. Möjliga värden är: "SMB", "NFS"

Typ:	String
Godkända värden:	NFS, SMB
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Metadata

Dela metadata

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Namn på Azure-filresurs

Typ:	String
Alias:	N, ShareName
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PaidBurstingEnabled

Anger om betald bursting är aktiverat för resursen. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v1 SSD-kontotypen.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PaidBurstingMaxBandwidthMibps

Den maximala betalda burst-bandbredden för resursen, i mebibyte per sekund. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v1 SSD-kontotypen. Det högsta tillåtna värdet är 10340, vilket är den maximala tillåtna bandbredden för en resurs.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PaidBurstingMaxIops

Den maximala betalda IOPS för resursen. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v1 SSD-kontotypen. Det högsta tillåtna värdet är 102400, vilket är det högsta tillåtna IOPS-värdet för en resurs.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ProvisionedBandwidthMibps

Den etablerade bandbredden för resursen i mebibyte per sekund. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v2-kontotyp. Se Get-AzStorageFileServiceUsage cmdlet-utdata för det lägsta och högsta tillåtna värdet för etablerad bandbredd.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ProvisionedIops

Resursens etablerade IOPS. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v2-kontotyp. Se Get-AzStorageFileServiceUsage cmdlet-utdata för det lägsta och högsta tillåtna värdet för etablerad IOPS.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-QuotaGiB

Dela kvot i Gibibyte.

Typ:	Int32
Alias:	Quota
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupName

Namn på resursgrupp.

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RootSquash

Anger minskning av åtkomsträttigheterna för fjärrsuperanvändaren. Möjliga värden är: "NoRootSquash", "RootSquash", "AllSquash"

Typ:	String
Godkända värden:	NoRootSquash, RootSquash, AllSquash
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Snapshot

Skapa en ögonblicksbild av befintlig resurs med samma namn.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-StorageAccount

Lagringskontoobjekt

Typ:	PSStorageAccount
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-StorageAccountName

Lagringskontonamn.

Typ:	String
Alias:	AccountName
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

String

PSStorageAccount

Utdata

PSShare

Dela via