Update-AzRmStorageShare

Referens

Modul:: Az.Storage

Ändrar en lagringsfilresurs.

Syntax

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

Update-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      [-ResourceId] <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRmStorageShare
      -InputObject <PSShare>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten New-AzRmStorageShare ändrar en lagringsfilresurs.

Exempel

Exempel 1: Ändrar metadata för en lagringsfilresurs och resurskvot med lagringskontots namn och resursnamn

$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

Det här kommandot ändrar lagringsfilresursens metadata och resurskvot med lagringskontots namn och resursnamn och visar ändringsresultatet med det returnerade filresursobjektet.

Exempel 2: Ändrar metadata för en lagringsfilresurs med lagringskontoobjekt och resursnamn

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
$share = Update-AzRmStorageShare -StorageAccount $accountObject -Name "myshare" -Metadata @{tag0="value0";tag1="value1"}

Det här kommandot ändrar metadata på en lagringsfilresurs med lagringskontoobjekt och resursnamn.

Exempel 3: Ändrar resurskvoten för alla lagringsfilresurser i ett lagringskonto med pipeline

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

Det här kommandot ändrar resurskvoten till 5 000 GiB för alla lagringsfilresurser i ett lagringskonto med pipeline.

Exempel 4: Ändra en lagringsfilresurs med accesstier som Lågfrekvent

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Cool

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Det här kommandot ändrar en lagringsfilresurs med accesstier som Lågfrekvent.

Exempel 5: Ändrar rootsquash för en filresurs i ett lagringskonto

$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

Det här kommandot ändrar resursen RootSquash-egenskapen till NoRootSquash. Egenskapen RootSquash är endast avaialbe på resursen med EnabledProtocol som NFS.

Exempel 6: Ändrar en lagringsfilresurs med etablerad bandbredd och IOPS

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

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

Exempel 7: Ändrar en lagringsfilresurs med betald bandbredd och IOPS

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

Det här kommandot ändrar 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

-InputObject

Lagringsresursobjekt

Typ:	PSShare
Alias:	Share
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
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

Resursnamn

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:	Boolean
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

-ResourceId

Ange ett resurs-ID för filresurs.

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
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

-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

PSShare

Utdata