Update-AzRmStorageShare

Referenz

Modul:: Az.Storage

Ändert eine Speicherdateifreigabe.

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

Beschreibung

Das Cmdlet New-AzRmStorageShare ändert eine Speicherdateifreigabe.

Beispiele

Beispiel 1: Ändert die Metadaten und das Freigabekontingent einer Speicherdateifreigabe mit dem Namen und dem Freigabenamen des Speicherkontos.

$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

Dieser Befehl ändert die Metadaten und das Freigabekontingent einer Speicherdatei mit dem Namen und dem Freigabenamen des Speicherkontos und zeigt das Änderungsergebnis mit dem zurückgegebenen Dateifreigabeobjekt an.

Beispiel 2: Ändert Metadaten für eine Speicherdateifreigabe mit Speicherkontoobjekt und Freigabename

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

Mit diesem Befehl werden Metadaten für eine Speicherdateifreigabe mit dem Speicherkontoobjekt und dem Freigabenamen geändert.

Beispiel 3: Ändert das Freigabekontingent für alle Speicherdateifreigaben in einem Speicherkonto mit 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

Mit diesem Befehl wird das Freigabekontingent als 5000 GiB für alle Speicherdateifreigaben in einem Speicherkonto mit Pipeline geändert.

Beispiel 4: Ändern einer Speicherdateifreigabe mit Accesstier als cool

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Mit diesem Befehl wird eine Speicherdateifreigabe mit Accesstier als Cool geändert.

Beispiel 5: Ändert rootsquash für eine Dateifreigabe in einem Speicherkonto.

$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

Mit diesem Befehl wird die RootSquash-Eigenschaft in "NoRootSquash" geändert. Die RootSquash-Eigenschaft ist nur für die Freigabe mit EnabledProtocol als NFS verfügbar.

Beispiel 6: Ändert eine Speicherdateifreigabe mit bereitgestellter Bandbreite und IOPS

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

Mit diesem Befehl wird eine Speicherdateifreigabe mit bereitgestellter Bandbreite und IOPS geändert, sie funktioniert nur für den Kontotyp "Bereitgestellte Dateien v2".

Beispiel 7: Ändert eine Speicherdateifreigabe mit kostenpflichtiger Platzbandbreite und IOPS

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

Mit diesem Befehl wird eine Speicherdateifreigabe mit kostenpflichtiger Platzbandbreite und IOPS geändert, sie funktioniert nur für den Kontotyp "Bereitgestellte Dateien v1".

Parameter

-AccessTier

Zugriffsebene für bestimmte Freigaben. StorageV2-Konto kann zwischen TransactionOptimized (Standard), Hot und Cool wählen. FileStorage-Konto kann Premium auswählen.

Typ:	String
Zulässige Werte:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Storage Share-Objekt

Typ:	PSShare
Aliase:	Share
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Metadata

Freigeben von Metadaten

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Name

Freigabename

Typ:	String
Aliase:	N, ShareName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PaidBurstingEnabled

Gibt an, ob kostenpflichtiges Bursting für die Freigabe aktiviert ist. Diese Eigenschaft gilt nur für Dateifreigaben, die unter dem Ssd-Kontotyp "Files Provisioned v1" erstellt wurden.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PaidBurstingMaxBandwidthMibps

Die maximale bezahlte Platzbandbreite für den Anteil pro Sekunde in Mebibytes. Diese Eigenschaft gilt nur für Dateifreigaben, die unter dem Ssd-Kontotyp "Files Provisioned v1" erstellt wurden. Der maximal zulässige Wert ist 10340, was die maximale zulässige Bandbreite für eine Freigabe ist.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PaidBurstingMaxIops

Die maximal bezahlten IOPS für die Aktie. Diese Eigenschaft gilt nur für Dateifreigaben, die unter dem Ssd-Kontotyp "Files Provisioned v1" erstellt wurden. Der maximal zulässige Wert ist 102400, was die maximal zulässigen IOPS für eine Freigabe ist.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ProvisionedBandwidthMibps

Die bereitgestellte Bandbreite der Freigabe in mebibytes pro Sekunde. Diese Eigenschaft ist nur für Dateifreigaben vorgesehen, die unter dem Kontotyp "Files Provisioned v2" erstellt wurden. Weitere Informationen finden Sie in der ausgabe des Get-AzStorageFileServiceUsage Cmdlets für den minimalen und maximal zulässigen Wert für die bereitgestellte Bandbreite.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ProvisionedIops

Die bereitgestellten IOPS der Freigabe. Diese Eigenschaft ist nur für Dateifreigaben vorgesehen, die unter dem Kontotyp "Files Provisioned v2" erstellt wurden. Bitte lesen Sie die Get-AzStorageFileServiceUsage Cmdlet-Ausgabe für den minimalen und maximal zulässigen Wert für bereitgestellte IOPS.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-QuotaGiB

Freigabekontingent in Gibibyte.

Typ:	Int32
Aliase:	Quota
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Ressourcengruppenname.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceId

Geben Sie eine Ressourcen-ID für dateifreigaben ein.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-RootSquash

Legt die Reduzierung der Zugriffsrechte für den Remote-Superuser fest. Mögliche Werte sind: 'NoRootSquash', 'RootSquash', 'AllSquash'

Typ:	String
Zulässige Werte:	NoRootSquash, RootSquash, AllSquash
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-StorageAccount

Speicherkontoobjekt

Typ:	PSStorageAccount
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-StorageAccountName

Speicherkontoname.

Typ:	String
Aliase:	AccountName
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

PSStorageAccount

PSShare

Ausgaben