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>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-QuotaGiB <Int32>]
   [-Metadata <Hashtable>]
   [-AccessTier <String>]
   [-Snapshot]
   [-EnabledProtocol <String>]
   [-RootSquash <String>]
   [-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.

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 zobrazí výzvu 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

-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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Výstupy

PSShare