Dela via

New-AzRmStorageShare

Modul:
Az.Storage Module

Skapar en lagringsfilresurs.

Syntax

AccountName (Standard) 

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

Cmdleten New-AzRmStorageShare skapar en lagringsfilresurs.

Exempel

Exempel 1: Skapa en lagringsfilresurs med lagringskontots namn och resursnamn, med metadata och resurskvot som 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

Det här kommandot skapar en lagringsfilresurs med metadata och resurskvot som 100 GiB.

Exempel 2: Skapa en lagringsfilresurs med lagringskontoobjekt

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Det här kommandot skapar en lagringsfilresurs med lagringskontoobjektet och resursnamnet.

Exempel 3: Skapa en lagringsfilresurs med accesstier som Frekvent

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Det här kommandot skapar en lagringsfilresurs med åtkomsttier som Frekvent.

Exempel 4: Skapa en ögonblicksbild av en lagringsfilresurs av en befintlig resurs

$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

Det här kommandot skapar en ögonblicksbild av en lagringsfilresurs av en befintlig basfilresurs.

Exempel 5: Skapa en lagringsfilresurs med egenskapen EnabledProtocol som NFS och egenskapen RootSquash som 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

Det här kommandot skapar en lagringsfilresurs med egenskapen EnabledProtocol som NFS och egenskapen RootSquash som NoRootSquash.

Exempel 6: Skapa en lagringsfilresurs med etablerad bandbredd och IOPS

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

Det här kommandot skapar en lagringsfilresurs med etablerad bandbredd och IOPS. Det fungerar bara med kontotypen Files Provisioned v2.

Exempel 7: Skapa en lagringsfilresurs med betald bandbredd och IOPS

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

Det här kommandot skapar en lagringsfilresurs med betald bandbredd och IOPS. Det fungerar bara med kontotypen Files Provisioned v1.

Parametrar

-AccessTier

Åtkomstnivå för specifik resurs. StorageV2-kontot kan välja mellan TransactionOptimized (standard), Frekvent och Lågfrekvent. FileStorage-kontot kan välja Premium.

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:TransactionOptimized, Premium, Hot, Cool
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EnabledProtocol

Anger protokoll för filresurser. Det går inte att ändra den när filresursen har skapats. Möjliga värden är: "SMB", "NFS"

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:NFS, SMB
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Metadata

Dela metadata

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Namn på Azure-filresurs

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:N, ShareName

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PaidBurstingEnabled

Anger om betald bursting är aktiverat för resursen. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v1 SSD-kontotypen.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PaidBurstingMaxBandwidthMibps

Den maximala betalda burst-bandbredden för resursen, i mebibyte per sekund. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v1 SSD-kontotypen. Det högsta tillåtna värdet är 10340, vilket är den maximala tillåtna bandbredden för en resurs.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PaidBurstingMaxIops

Den maximala betalda IOPS för resursen. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v1 SSD-kontotypen. Det högsta tillåtna värdet är 102400, vilket är det högsta tillåtna IOPS-värdet för en resurs.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ProvisionedBandwidthMibps

Den etablerade bandbredden för resursen i mebibyte per sekund. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v2-kontotyp. Se Get-AzStorageFileServiceUsage cmdlet-utdata för det lägsta och högsta tillåtna värdet för etablerad bandbredd.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ProvisionedIops

Resursens etablerade IOPS. Den här egenskapen är endast för filresurser som skapats under Files Provisioned v2-kontotyp. Se Get-AzStorageFileServiceUsage cmdlet-utdata för det lägsta och högsta tillåtna värdet för etablerad IOPS.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-QuotaGiB

Dela kvot i Gibibyte.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Quota

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ResourceGroupName

Namn på resursgrupp.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AccountName
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RootSquash

Anger minskning av åtkomsträttigheterna för fjärrsuperanvändaren. Möjliga värden är: "NoRootSquash", "RootSquash", "AllSquash"

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:NoRootSquash, RootSquash, AllSquash
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Snapshot

Skapa en ögonblicksbild av befintlig resurs med samma namn.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-StorageAccount

Lagringskontoobjekt

Parameteregenskaper

Typ:PSStorageAccount
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AccountObject
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-StorageAccountName

Lagringskontonamn.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:KontoNamn

Parameteruppsättningar

AccountName
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

PSStorageAccount

Utdata

PSShare