Udostępnij za pośrednictwem

New-AzRmStorageShare

  • Odwołanie
Moduł:
Az.Storage

Tworzy udział plików usługi Storage.

Składnia

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

Opis

Polecenie cmdlet New-AzRmStorageShare tworzy udział plików usługi Storage.

Przykłady

Przykład 1: Utwórz udział plików magazynu z nazwą konta magazynu i nazwą udziału, z metadanymi i limitem przydziału udziału 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

To polecenie tworzy udział plików magazynu z metadanymi i przydziałem udziału jako 100 GiB.

Przykład 2. Tworzenie udziału plików magazynu za pomocą obiektu konta magazynu

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

To polecenie tworzy udział plików usługi Storage z obiektem konta magazynu i nazwą udziału.

Przykład 3. Tworzenie udziału plików magazynu z dostępem bardziej gorącym

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

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

To polecenie tworzy udział plików magazynu z dostępemtier jako Gorąca.

Przykład 4. Tworzenie migawki udziału plików magazynu istniejącego udziału

$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

To polecenie tworzy migawkę udziału plików magazynu istniejącego podstawowego udziału plików.

Przykład 5. Tworzenie udziału plików magazynu z proeprty enabledProtocol jako NFS i właściwości 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

To polecenie tworzy udział plików magazynu z włączonymprotocol proeprty jako NFS i RootSquash proeprty jako NoRootSquash.

Przykład 6. Tworzenie udziału plików magazynu z aprowizowaną przepustowością i operacjami we/wy na sekundę

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

To polecenie tworzy udział plików magazynu z aprowizowaną przepustowością i liczbami we/wy na sekundę, działa tylko na typ konta Files Provisioned v2.

Przykład 7. Tworzenie udziału plików magazynu z płatną przepustowością i operacjami we/wy na sekundę

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

To polecenie tworzy udział plików magazynu z płatną przepustowością i liczbami we/wy na sekundę, działa tylko na typ konta Files Provisioned v1.

Parametry

-AccessTier

Warstwa dostępu dla określonego udziału. Konto storageV2 może wybrać między TransactionOptimized (wartość domyślna), Gorąca i Chłodna. Konto FileStorage może wybrać pozycję Premium.

Typ:String
Dopuszczalne wartości:TransactionOptimized, Premium, Hot, Cool
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnabledProtocol

Ustawia protokoły dla udziałów plików. Nie można go zmienić po utworzeniu udziału plików. Możliwe wartości to: "SMB", "NFS"

Typ:String
Dopuszczalne wartości:NFS, SMB
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Metadata

Udostępnianie metadanych

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa udziału plików platformy Azure

Typ:String
Aliasy:N, ShareName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PaidBurstingEnabled

Wskazuje, czy płatne skalowanie jest włączone dla udziału. Ta właściwość dotyczy tylko udziałów plików utworzonych w obszarze Pliki aprowizowanego typu konta SSD w wersji 1.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PaidBurstingMaxBandwidthMibps

Maksymalna płatna przepustowość dla udziału w mebibajtach na sekundę. Ta właściwość dotyczy tylko udziałów plików utworzonych w obszarze Pliki aprowizowanego typu konta SSD w wersji 1. Maksymalna dozwolona wartość to 10340, która jest maksymalną dozwoloną przepustowością dla udziału.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PaidBurstingMaxIops

Maksymalna płatna liczba operacji we/wy na sekundę dla udziału. Ta właściwość dotyczy tylko udziałów plików utworzonych w obszarze Pliki aprowizowanego typu konta SSD w wersji 1. Maksymalna dozwolona wartość to 102400, czyli maksymalna dozwolona liczba operacji we/wy na sekundę dla udziału.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProvisionedBandwidthMibps

Aprowizowana przepustowość udziału w mebibajtach na sekundę. Ta właściwość dotyczy tylko udziałów plików utworzonych w obszarze Pliki Aprowizowany typ konta w wersji 2. Zapoznaj się z danymi wyjściowymi polecenia cmdlet Get-AzStorageFileServiceUsage, aby uzyskać minimalną i maksymalną dozwoloną wartość dla aprowizowanej przepustowości.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProvisionedIops

Aprowizowana liczba operacji we/wy na sekundę udziału. Ta właściwość dotyczy tylko udziałów plików utworzonych w obszarze Pliki Aprowizowany typ konta w wersji 2. Zapoznaj się z danymi wyjściowymi polecenia cmdlet Get-AzStorageFileServiceUsage, aby uzyskać minimalną i maksymalną dozwoloną wartość aprowizowania operacji we/wy na sekundę.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-QuotaGiB

Limit przydziału udziału w gibibajcie.

Typ:Int32
Aliasy:Quota
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RootSquash

Ustawia zmniejszenie praw dostępu dla zdalnego superużytkownika. Możliwe wartości to: "NoRootSquash", "RootSquash", "AllSquash"

Typ:String
Dopuszczalne wartości:NoRootSquash, RootSquash, AllSquash
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Snapshot

Utwórz migawkę istniejącego udziału o tej samej nazwie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StorageAccount

Obiekt konta magazynu

Typ:PSStorageAccount
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountName

Nazwa konta magazynu.

Typ:String
Aliasy:AccountName
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Dane wyjściowe