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
Azure PowerShell