Sdílet prostřednictvím

New-AzRmStorageShare

  • Reference
Modul:
Az.Storage

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

Syntaxe

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>]
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 proeprtou jako NFS a vlastnost RootSquash jako 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 proeprtou proeprty EnabledProtocol jako NFS a RootSquash proeprty 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.

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

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

Typ:String
Přípustné hodnoty:NFS, SMB
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
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 Azure

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

-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

-Snapshot

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

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

Výstupy