New-AzRmStorageContainer
Tworzy kontener obiektów blob usługi Storage
Składnia
New-AzRmStorageContainer
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
-Name <String>
[-PublicAccess <PSPublicAccess>]
[-Metadata <Hashtable>]
[-RootSquash <String>]
[-EnableImmutableStorageWithVersioning]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzRmStorageContainer
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
-Name <String>
-DefaultEncryptionScope <String>
-PreventEncryptionScopeOverride <Boolean>
[-PublicAccess <PSPublicAccess>]
[-Metadata <Hashtable>]
[-RootSquash <String>]
[-EnableImmutableStorageWithVersioning]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzRmStorageContainer
-StorageAccount <PSStorageAccount>
-Name <String>
[-PublicAccess <PSPublicAccess>]
[-Metadata <Hashtable>]
[-RootSquash <String>]
[-EnableImmutableStorageWithVersioning]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzRmStorageContainer
-StorageAccount <PSStorageAccount>
-Name <String>
-DefaultEncryptionScope <String>
-PreventEncryptionScopeOverride <Boolean>
[-PublicAccess <PSPublicAccess>]
[-Metadata <Hashtable>]
[-RootSquash <String>]
[-EnableImmutableStorageWithVersioning]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet New-AzRmStorageContainer tworzy kontener obiektów blob usługi Storage
Przykłady
Przykład 1: Tworzenie kontenera obiektów blob usługi Storage z nazwą konta magazynu i nazwą kontenera z metadanymi
New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" -Metadata @{tag0="value0";tag1="value1";tag2="value2"}
To polecenie tworzy kontener obiektów blob usługi Storage z nazwą konta usługi Storage i nazwą kontenera z metadanymi.
Przykład 2. Tworzenie kontenera obiektów blob usługi Storage z obiektem konta usługi Storage i nazwą kontenera z dostępem publicznym jako obiekt blob
$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount"
New-AzRmStorageContainer -StorageAccount $accountObject -ContainerName "myContainer" -PublicAccess Blob
To polecenie tworzy kontener obiektów blob usługi Storage z obiektem konta usługi Storage i nazwą kontenera z dostępem publicznym jako obiekt blob.
Przykład 3. Tworzenie kontenera magazynu przy użyciu ustawienia EncryptionScope
$c = New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "mystorageaccount" -Name testcontainer -DefaultEncryptionScope "testscope" -PreventEncryptionScopeOverride $true
$c
ResourceGroupName: myResourceGroup, StorageAccountName: mystorageaccount
Name PublicAccess LastModified HasLegalHold HasImmutabilityPolicy
---- ------------ ------------ ------------ ---------------------
testcontainer False False
$c.DefaultEncryptionScope
testscope
$c.DenyEncryptionScopeOverride
True
To polecenie tworzy kontener magazynu z defalt encryptionScope i blokuje zastąpienie zakresu szyfrowania z domyślnego kontenera. Następnie pokaż powiązane właściwości kontenera.
Przykład 4. Tworzenie kontenera usługi Azure Storage przy użyciu polecenia RootSquash
$container = New-AzRmStorageContainer -ResourceGroupName "myersourcegroup" -AccountName "mystorageaccount" -Name "mycontainer" -RootSquash AllSquash
$container.EnableNfsV3AllSquash
True
$container.EnableNfsV3RootSquash
False
To polecenie tworzy kontener magazynu z właściwością RootSquash ustawioną jako AllSquash. RootSquash działa tylko na koncie magazynu, które włączyło NfsV3.
Przykład 5. Tworzenie kontenera magazynu i włączanie niezmiennego magazynu z przechowywaniem wersji
$c = New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "mystorageaccount" -Name testcontainer -EnableImmutableStorageWithVersioning
$c
ResourceGroupName: myResourceGroup, StorageAccountName: mystorageaccount
Name PublicAccess LastModified HasLegalHold HasImmutabilityPolicy Deleted VersionId ImmutableStorageWithVersioning
---- ------------ ------------ ------------ --------------------- ------- --------- ------------------------------
testcontainer None 2021-07-19 08:26:19Z False False False True
To polecenie tworzy kontener magazynu i włącza niezmienny magazyn z przechowywaniem wersji. Polecenie działa tylko wtedy, gdy konto magazynu ma już włączone przechowywanie wersji obiektów blob.
Parametry
-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 |
-DefaultEncryptionScope
Domyślnie kontener używa określonego zakresu szyfrowania dla wszystkich zapisów.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
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 |
-EnableImmutableStorageWithVersioning
Włącz niezmienny magazyn z przechowywaniem wersji na poziomie kontenera.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Metadata
Metadane kontenera
Typ: | Hashtable |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa kontenera
Typ: | String |
Aliasy: | N, ContainerName |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-PreventEncryptionScopeOverride
Blokuj zastępowanie zakresu szyfrowania z domyślnego kontenera.
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PublicAccess
Container PublicAccess
Typ: | PSPublicAccess |
Dopuszczalne wartości: | Container, Blob, None |
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: | True |
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 |
-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: | True |
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 |