New-AzRmStorageShare

Modul:

Az.Storage Module

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

Syntax

AccountName (Výchozí)

New-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -Name <String>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-Snapshot]
    [-EnabledProtocol <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountObject

New-AzRmStorageShare
    -StorageAccount <PSStorageAccount>
    -Name <String>
    [-QuotaGiB <Int32>]
    [-Metadata <Hashtable>]
    [-AccessTier <String>]
    [-Snapshot]
    [-EnabledProtocol <String>]
    [-RootSquash <String>]
    [-ProvisionedBandwidthMibps <Int32>]
    [-ProvisionedIops <Int32>]
    [-PaidBurstingEnabled]
    [-PaidBurstingMaxIops <Int32>]
    [-PaidBurstingMaxBandwidthMibps <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

Příklady

Příklad 1: Vytvořte sdílenou složku úložiště s názvem účtu úložiště a názvem sdílené složky s metadaty a kvótou sdílení jako 100 GiB.

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 100 -Metadata @{"tag1" = "value1"; "tag2" = "value2" }

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocol AccessTier Deleted Version ShareUsageBytes
----     -------- --------------- ---------- ------- ------- ---------------
myshare

Tento příkaz vytvoří sdílenou složku úložiště s metadaty a kvótou sdílené složky jako 100 GiB.

Příklad 2: Vytvoření sdílené složky úložiště s objektem účtu úložiště

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | New-AzRmStorageShare -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocol AccessTier Deleted Version ShareUsageBytes
----     -------- --------------- ---------- ------- ------- ---------------
myshare

Tento příkaz vytvoří sdílenou složku úložiště s objektem účtu úložiště a názvem sdílené složky.

Příklad 3: Vytvoření sdílené složky úložiště s přístupovým parametrem Hot

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Hot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Tento příkaz vytvoří sdílenou složku úložiště s přístupovou složkou hot.

Příklad 4: Vytvoření snímku sdílené složky úložiště existující sdílené složky

$shareSnapshot = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -Snapshot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes snapshotTime
----     -------- ---------------- ---------- ------- ------- --------------- ------------
myshare                                                                       2021-05-10T08:04:08

Tento příkaz vytvoří snímek sdílené složky úložiště existující základní sdílené složky.

Příklad 5: Vytvoření sdílené složky úložiště s povolenou vlastností EnabledProtocol jako NFS a RootSquash vlastnost NoRootSquash

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -EnabledProtocol NFS -RootSquash NoRootSquash

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.RootSquash
NoRootSquash

Tento příkaz vytvoří sdílenou složku úložiště s povolenou vlastností EnabledProtocol jako NFS a RootSquash vlastnost jako NoRootSquash.

Příklad 6: Vytvoření sdílené složky ú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 vytvoří sdílenou složku úložiště se zřízenou šířkou pásma a IOPS, funguje jenom na typu účtu Files Provisioned v2.

Příklad 7: Vytvoření sdílené složky ú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 vytvoří sdílenou složku úložiště s placenou šířkou pásma a vstupně-výstupními operacemi za sekundu, ale funguje jenom na typu účtu Files Provisioned 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

-EnabledProtocol

Nastaví protokoly pro sdílené složky. Po vytvoření sdílené složky ji nelze změnit. Mezi možné hodnoty patří: SMB, NFS.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	NFS, SMB
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

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

Vlastnosti parametru

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

Sady parametrů

(All)

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:	SwitchParameter
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

-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

-Snapshot

Vytvořte snímek existující sdílené složky se stejným názvem.

Vlastnosti parametru

Typ:	SwitchParameter
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

-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

Výstupy

PSShare