Delen via


Update-AzRmStorageShare

Hiermee wijzigt u een opslagbestandsshare.

Syntaxis

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

De cmdlet New-AzRmStorageShare wijzigt een Storage-bestandsshare.

Voorbeelden

Voorbeeld 1: hiermee wijzigt u de metagegevens van een opslagbestandsshare en deelt u het quotum met de naam van het opslagaccount en de sharenaam

$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

Met deze opdracht wijzigt u de metagegevens en het quotum voor een opslagbestandsshare met de naam van het opslagaccount en de sharenaam en geeft u het wijzigingsresultaat weer met het geretourneerde bestandsshareobject.

Voorbeeld 2: wijzigt metagegevens op een opslagbestandsshare met het opslagaccountobject en de naam van de share

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

Met deze opdracht worden metagegevens op een Opslagbestandsshare gewijzigd met het opslagaccountobject en de naam van de share.

Voorbeeld 3: hiermee wijzigt u het quotum voor alle opslagbestandsshares in een opslagaccount met pijplijn

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

Met deze opdracht wijzigt u het quotum voor delen als 5000 GiB voor alle opslagbestandsshares in een opslagaccount met pijplijn.

Voorbeeld 4: Een opslagbestandsshare wijzigen met accesstier als Statisch

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Met deze opdracht wijzigt u een Opslagbestandsshare met accesstier als Statisch.

Voorbeeld 5: wijzigt rootsquash voor een bestandsshare in een opslagaccount

$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

Met deze opdracht wordt de eigenschap RootSquash gewijzigd in NoRootSquash. De eigenschap RootSquash is alleen beschikbaar op share met EnabledProtocol als NFS.

Voorbeeld 6: Hiermee wijzigt u een opslagbestandsshare met ingerichte bandbreedte en IOPS

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

Met deze opdracht wordt een opslagbestandsshare gewijzigd met ingerichte bandbreedte en IOPS. Deze opdracht werkt alleen voor het accounttype Files Provisioned v2.

Voorbeeld 7: Wijzigt een opslagbestandsshare met betaalde bursting-bandbreedte en IOPS

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

Met deze opdracht wijzigt u een opslagbestandsshare met betaalde burstingbandbreedte en IOPS. Het werkt alleen op het accounttype Bestanden ingericht v1.

Parameters

-AccessTier

Toegangslaag voor specifieke share. Het StorageV2-account kan kiezen tussen TransactionOptimized (standaard), Hot en Cool. FileStorage-account kan Premium kiezen.

Type:String
Geaccepteerde waarden:TransactionOptimized, Premium, Hot, Cool
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Opslagshareobject

Type:PSShare
Aliassen:Share
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Metadata

Metagegevens delen

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Naam van share

Type:String
Aliassen:N, ShareName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PaidBurstingEnabled

Geeft aan of betaalde bursting is ingeschakeld voor de share. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder het accounttype Files Provisioned v1 SSD.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PaidBurstingMaxBandwidthMibps

De maximale betaalde burst-bandbreedte voor de share, in mebibytes per seconde. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder het accounttype Files Provisioned v1 SSD. De maximaal toegestane waarde is 10340. Dit is de maximaal toegestane bandbreedte voor een share.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PaidBurstingMaxIops

De maximaal betaalde bursting-IOPS voor de share. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder het accounttype Files Provisioned v1 SSD. De maximaal toegestane waarde is 102400, de maximaal toegestane IOPS voor een share.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProvisionedBandwidthMibps

De ingerichte bandbreedte van de share, in mebibytes per seconde. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder Het accounttype Files Provisioned v2. Raadpleeg de uitvoer van de Get-AzStorageFileServiceUsage cmdlet voor de minimum- en maximumwaarde die is toegestaan voor ingerichte bandbreedte.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProvisionedIops

De ingerichte IOPS van de share. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder Het accounttype Files Provisioned v2. Raadpleeg de uitvoer van de Get-AzStorageFileServiceUsage cmdlet voor de minimaal en maximaal toegestane waarde voor ingerichte IOPS.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-QuotaGiB

Quotum delen in Gibibyte.

Type:Int32
Aliassen:Quota
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Naam van resourcegroep.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceId

Voer de resource-id van een bestandsshare in.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RootSquash

Hiermee stelt u het beperken van de toegangsrechten voor de externe supergebruiker in. Mogelijke waarden zijn: 'NoRootSquash', 'RootSquash', 'AllSquash'

Type:String
Geaccepteerde waarden:NoRootSquash, RootSquash, AllSquash
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StorageAccount

Opslagaccountobject

Type:PSStorageAccount
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StorageAccountName

Naam van opslagaccount.

Type:String
Aliassen:AccountName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uitvoerwaarden