Delen via

New-AzRmStorageShare

  • Referentie
Module:
Az.Storage

Hiermee maakt u een Opslagbestandsshare.

Syntaxis

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

De cmdlet New-AzRmStorageShare maakt een Storage-bestandsshare.

Voorbeelden

Voorbeeld 1: Maak een opslagbestandsshare met de naam van het opslagaccount en de naam van de share, met metagegevens en het quotum voor delen als 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

Met deze opdracht maakt u een opslagbestandsshare met metagegevens en een quotum voor delen als 100 GiB.

Voorbeeld 2: Een opslagbestandsshare maken met opslagaccountobject

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Met deze opdracht maakt u een Opslagbestandsshare met het opslagaccountobject en de naam van de share.

Voorbeeld 3: Een opslagbestandsshare maken met accesstier als Dynamisch

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Met deze opdracht maakt u een Opslagbestandsshare met accesstier als Dynamisch.

Voorbeeld 4: Een momentopname van een opslagbestandsshare van een bestaande share maken

$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

Met deze opdracht maakt u een momentopname van een opslagbestandsshare van een bestaande basisbestandsshare.

Voorbeeld 5: Een opslagbestandsshare maken met EnabledProtocol proeprty als NFS en de eigenschap RootSquash als 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

Met deze opdracht maakt u een opslagbestandsshare met EnabledProtocol proeprty als NFS en RootSquash proeprty als NoRootSquash.

Voorbeeld 6: Een opslagbestandsshare maken met ingerichte bandbreedte en IOPS

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

Met deze opdracht maakt u een opslagbestandsshare met ingerichte bandbreedte en IOPS. Het werkt alleen voor het accounttype Files Provisioned v2.

Voorbeeld 7: Een opslagbestandsshare maken met betaalde burstingbandbreedte en IOPS

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

Met deze opdracht maakt u een Opslagbestandsshare met betaalde burstingbandbreedte en IOPS. Het werkt alleen voor het accounttype Files Provisioned v1.

Parameters

-AccessTier

Toegangslaag voor specifieke share. Het StorageV2-account kan kiezen tussen TransactionOptimized (standaard), Hot en Cool. FileStorage-account kan Premium kiezen.

Type:String
Geaccepteerde waarden:TransactionOptimized, Premium, Hot, Cool
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EnabledProtocol

Hiermee stelt u protocollen voor bestandsshares in. Het kan niet worden gewijzigd nadat de bestandsshare is gemaakt. Mogelijke waarden zijn: 'SMB', 'NFS'

Type:String
Geaccepteerde waarden:NFS, SMB
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Metadata

Metagegevens delen

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Naam van Azure-bestandsshare

Type:String
Aliassen:N, ShareName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PaidBurstingEnabled

Geeft aan of betaalde bursting is ingeschakeld voor de share. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder het accounttype Files Provisioned v1 SSD.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PaidBurstingMaxBandwidthMibps

De maximale betaalde burst-bandbreedte voor de share, in mebibytes per seconde. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder het accounttype Files Provisioned v1 SSD. De maximaal toegestane waarde is 10340. Dit is de maximaal toegestane bandbreedte voor een share.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PaidBurstingMaxIops

De maximaal betaalde bursting-IOPS voor de share. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder het accounttype Files Provisioned v1 SSD. De maximaal toegestane waarde is 102400, de maximaal toegestane IOPS voor een share.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProvisionedBandwidthMibps

De ingerichte bandbreedte van de share, in mebibytes per seconde. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder Het accounttype Files Provisioned v2. Raadpleeg de uitvoer van de Get-AzStorageFileServiceUsage cmdlet voor de minimum- en maximumwaarde die is toegestaan voor ingerichte bandbreedte.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProvisionedIops

De ingerichte IOPS van de share. Deze eigenschap is alleen bedoeld voor bestandsshares die zijn gemaakt onder Het accounttype Files Provisioned v2. Raadpleeg de uitvoer van de Get-AzStorageFileServiceUsage cmdlet voor de minimaal en maximaal toegestane waarde voor ingerichte IOPS.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-QuotaGiB

Quotum delen in Gibibyte.

Type:Int32
Aliassen:Quota
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Naam van resourcegroep.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RootSquash

Hiermee stelt u het beperken van de toegangsrechten voor de externe supergebruiker in. Mogelijke waarden zijn: 'NoRootSquash', 'RootSquash', 'AllSquash'

Type:String
Geaccepteerde waarden:NoRootSquash, RootSquash, AllSquash
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Snapshot

Maak een momentopname van een bestaande share met dezelfde naam.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StorageAccount

Opslagaccountobject

Type:PSStorageAccount
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-StorageAccountName

Naam van opslagaccount.

Type:String
Aliassen:AccountName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Uitvoerwaarden