Freigeben über

New-AzRmStorageShare

  • Referenz
Modul:
Az.Storage

Erstellt eine Speicherdateifreigabe.

Syntax

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

Beschreibung

Das Cmdlet New-AzRmStorageShare erstellt eine Speicherdateifreigabe.

Beispiele

Beispiel 1: Erstellen Sie eine Speicherdateifreigabe mit dem Namen des Speicherkontos und dem Freigabenamen mit Metadaten und Freigabekontingent 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

Dieser Befehl erstellt eine Speicherdateifreigabe mit Metadaten und Freigabekontingent als 100 GiB.

Beispiel 2: Erstellen einer Speicherdateifreigabe mit speicherkontoobjekt

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Mit diesem Befehl wird eine Speicherdateifreigabe mit dem Speicherkontoobjekt und dem Freigabenamen erstellt.

Beispiel 3: Erstellen einer Speicherdateifreigabe mit Accesstier als 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

Mit diesem Befehl wird eine Speicherdateifreigabe mit Zugriff als Hot erstellt.

Beispiel 4: Erstellen einer Momentaufnahme der Speicherdateifreigabe einer vorhandenen Freigabe

$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

Mit diesem Befehl wird eine Momentaufnahme der Speicherdateifreigabe einer vorhandenen Basisdateifreigabe erstellt.

Beispiel 5: Erstellen einer Speicherdateifreigabe mit EnabledProtocol proeprty as NFS und RootSquash-Eigenschaft 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

Dieser Befehl erstellt eine Speicherdateifreigabe mit EnabledProtocol proeprty als NFS und RootSquash proeprty als NoRootSquash.

Beispiel 6: Erstellen einer Speicherdateifreigabe mit bereitgestellter Bandbreite und IOPS

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

Mit diesem Befehl wird eine Speicherdateifreigabe mit bereitgestellter Bandbreite und IOPS erstellt, die nur für den Kontotyp "Bereitgestellte Dateien v2" funktioniert.

Beispiel 7: Erstellen einer Speicherdateifreigabe mit kostenpflichtiger Platzbandbreite und IOPS

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

Mit diesem Befehl wird eine Speicherdateifreigabe mit kostenpflichtiger Platzbandbreite und IOPS erstellt, die nur für den Kontotyp "Bereitgestellte Dateien v1" funktioniert.

Parameter

-AccessTier

Zugriffsebene für bestimmte Freigaben. StorageV2-Konto kann zwischen TransactionOptimized (Standard), Hot und Cool wählen. FileStorage-Konto kann Premium auswählen.

Typ:String
Zulässige Werte:TransactionOptimized, Premium, Hot, Cool
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnabledProtocol

Legt Protokolle für Dateifreigaben fest. Sie kann nach der Erstellung der Dateifreigabe nicht mehr geändert werden. Mögliche Werte sind: 'SMB', 'NFS'

Typ:String
Zulässige Werte:NFS, SMB
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Metadata

Freigeben von Metadaten

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Name der Azure-Dateifreigabe

Typ:String
Aliase:N, ShareName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PaidBurstingEnabled

Gibt an, ob kostenpflichtiges Bursting für die Freigabe aktiviert ist. Diese Eigenschaft gilt nur für Dateifreigaben, die unter dem Ssd-Kontotyp "Files Provisioned v1" erstellt wurden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PaidBurstingMaxBandwidthMibps

Die maximale bezahlte Platzbandbreite für den Anteil pro Sekunde in Mebibytes. Diese Eigenschaft gilt nur für Dateifreigaben, die unter dem Ssd-Kontotyp "Files Provisioned v1" erstellt wurden. Der maximal zulässige Wert ist 10340, was die maximale zulässige Bandbreite für eine Freigabe ist.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PaidBurstingMaxIops

Die maximal bezahlten IOPS für die Aktie. Diese Eigenschaft gilt nur für Dateifreigaben, die unter dem Ssd-Kontotyp "Files Provisioned v1" erstellt wurden. Der maximal zulässige Wert ist 102400, was die maximal zulässigen IOPS für eine Freigabe ist.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProvisionedBandwidthMibps

Die bereitgestellte Bandbreite der Freigabe in mebibytes pro Sekunde. Diese Eigenschaft ist nur für Dateifreigaben vorgesehen, die unter dem Kontotyp "Files Provisioned v2" erstellt wurden. Weitere Informationen finden Sie in der ausgabe des Get-AzStorageFileServiceUsage Cmdlets für den minimalen und maximal zulässigen Wert für die bereitgestellte Bandbreite.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProvisionedIops

Die bereitgestellten IOPS der Freigabe. Diese Eigenschaft ist nur für Dateifreigaben vorgesehen, die unter dem Kontotyp "Files Provisioned v2" erstellt wurden. Bitte lesen Sie die Get-AzStorageFileServiceUsage Cmdlet-Ausgabe für den minimalen und maximal zulässigen Wert für bereitgestellte IOPS.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-QuotaGiB

Freigabekontingent in Gibibyte.

Typ:Int32
Aliase:Quota
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Ressourcengruppenname.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RootSquash

Legt die Reduzierung der Zugriffsrechte für den Remote-Superuser fest. Mögliche Werte sind: 'NoRootSquash', 'RootSquash', 'AllSquash'

Typ:String
Zulässige Werte:NoRootSquash, RootSquash, AllSquash
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Snapshot

Erstellen Sie eine Momentaufnahme einer vorhandenen Freigabe mit demselben Namen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageAccount

Speicherkontoobjekt

Typ:PSStorageAccount
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageAccountName

Speicherkontoname.

Typ:String
Aliase:AccountName
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben