Update-AzRmStorageShare

Reference

Modul:: Az.Storage

Upraví sdílenou složku úložiště.

Syntaxe

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

Rutina New-AzRmStorageShare upraví sdílenou složku úložiště.

Příklady

Příklad 1: Upraví metadata sdílené složky úložiště a kvótu sdílené složky pomocí názvu účtu úložiště a názvu sdílené složky.

$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

Tento příkaz upraví metadata sdílené složky úložiště a kvótu sdílené složky pomocí názvu účtu úložiště a názvu sdílené složky a zobrazí výsledek změny vráceným objektem sdílené složky.

Příklad 2: Upraví metadata sdílené složky úložiště pomocí objektu účtu úložiště a názvu sdílené složky.

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

Tento příkaz upraví metadata sdílené složky úložiště pomocí objektu účtu úložiště a názvu sdílené složky.

Příklad 3: Upraví kvótu sdílené složky pro všechny sdílené složky úložiště v účtu úložiště s kanálem.

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

Tento příkaz upraví kvótu sdílené složky jako 5000 GiB pro všechny sdílené složky úložiště v účtu úložiště s kanálem.

Příklad 4: Úprava sdílené složky úložiště s accesstier jako Studená

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Tento příkaz upraví sdílenou složku úložiště s accesstier jako Studenou.

Příklad 5: Upraví kořeny pro sdílené složky v účtu úložiště.

$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

Tento příkaz upraví vlastnost RootSquash na NoRootSquash. Vlastnost RootSquash je pouze avaialbe ve sdílené složce EnabledProtocol jako NFS.

Příklad 6: Upraví sdílenou složku úložiště se zřízenou šířkou pásma a IOPS.

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

Tento příkaz upraví sdílenou složku úložiště se zřízenou šířkou pásma a vstupně-výstupními operacemi za sekundu, ale funguje jenom u typu účtu Zřízené soubory v2.

Příklad 7: Upraví sdílenou složku úložiště s placenou šířkou pásma a vstupně-výstupními operacemi za sekundu.

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

Tento příkaz upraví sdílenou složku úložiště s placenou šířkou pásma a vstupně-výstupními operacemi za sekundu, ale funguje jenom u typu účtu Zřízené soubory v1.

Parametry

-AccessTier

Úroveň přístupu pro konkrétní sdílenou složku Účet StorageV2 si může vybrat mezi TransactionOptimized (výchozí), Horká a Studená. Účet FileStorage může zvolit Premium.

Typ:	String
Přípustné hodnoty:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Objekt sdílené složky úložiště

Typ:	PSShare
Aliasy:	Share
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Metadata

Sdílení metadat

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název sdílené složky

Typ:	String
Aliasy:	N, ShareName
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PaidBurstingEnabled

Určuje, jestli je pro sdílenou složku povolené placené shlukování. Tato vlastnost je určena pouze pro sdílené složky vytvořené v rámci typu účtu SSD Zřízené soubory v1.

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PaidBurstingMaxBandwidthMibps

Maximální placená šířka pásma pro sdílenou složku v mebibajtech za sekundu. Tato vlastnost je určena pouze pro sdílené složky vytvořené v rámci typu účtu SSD Zřízené soubory v1. Maximální povolená hodnota je 10340, což je maximální povolená šířka pásma pro sdílenou složku.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PaidBurstingMaxIops

Maximální počet placených vstupně-výstupních operací za sekundu pro sdílenou složku. Tato vlastnost je určena pouze pro sdílené složky vytvořené v rámci typu účtu SSD Zřízené soubory v1. Maximální povolená hodnota je 102400, což je maximální povolený počet vstupně-výstupních operací za sekundu pro sdílenou složku.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ProvisionedBandwidthMibps

Zřízená šířka pásma sdílené složky v mebibajtech za sekundu. Tato vlastnost je určena pouze pro sdílené složky vytvořené v rámci typu účtu Files Provisioned v2. Informace o minimální a maximální povolené hodnotě pro zřízenou šířku pásma najdete ve výstupu rutiny Get-AzStorageFileServiceUsage.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ProvisionedIops

Zřízený počet IOPS sdílené složky. Tato vlastnost je určena pouze pro sdílené složky vytvořené v rámci typu účtu Files Provisioned v2. Informace o minimální a maximální povolené hodnotě pro zřízené IOPS najdete ve výstupu rutiny Get-AzStorageFileServiceUsage.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-QuotaGiB

Kvóta sdílení v Gibibyte.

Typ:	Int32
Aliasy:	Quota
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Název skupiny prostředků

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceId

Zadejte ID prostředku sdílené složky.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-RootSquash

Nastaví snížení přístupových práv pro vzdáleného superuživatele. Mezi možné hodnoty patří: NoRootSquash, RootSquash, AllSquash.

Typ:	String
Přípustné hodnoty:	NoRootSquash, RootSquash, AllSquash
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StorageAccount

Objekt účtu úložiště

Typ:	PSStorageAccount
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageAccountName

Název účtu úložiště

Typ:	String
Aliasy:	AccountName
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

PSStorageAccount

PSShare

Výstupy