Update-AzRmStorageShare

Modul:

Az.Storage Module

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

Syntax

AccountName (Výchozí)

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

AccountObject

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

ShareResourceId

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

ShareObject

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 k dispozici pouze ve sdílené složce s 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.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	TransactionOptimized, Premium, Hot, Cool
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

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

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

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

Vlastnosti parametru

Typ:	PSShare
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Sdílet

Sady parametrů

ShareObject

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Metadata

Sdílení metadat

Vlastnosti parametru

Typ:	Hashtable
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Název sdílené složky

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	N, Název sdílené složky

Sady parametrů

AccountName

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

AccountObject

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Boolean
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-QuotaGiB

Kvóta sdílení v Gibibyte.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Quota

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ResourceGroupName

Název skupiny prostředků

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AccountName

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ResourceId

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ShareResourceId

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RootSquash

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

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	NoRootSquash, RootSquash, AllSquash
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-StorageAccount

Objekt účtu úložiště

Vlastnosti parametru

Typ:	PSStorageAccount
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AccountObject

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-StorageAccountName

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Název účtu

Sady parametrů

AccountName

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

PSStorageAccount

PSShare

Výstupy

PSShare