New-AzRmStorageShare
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>]
[-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>]
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.
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 |
-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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |