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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultEncryptionScope

Domyślnie kontener używa określonego zakresu szyfrowania dla wszystkich zapisów.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableImmutableStorageWithVersioning

Włącz niezmienny magazyn z przechowywaniem wersji na poziomie kontenera.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Metadata

Metadane kontenera

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Nazwa kontenera

Type:String
Aliases:N, ContainerName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PreventEncryptionScopeOverride

Blokuj zastępowanie zakresu szyfrowania z domyślnego kontenera.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicAccess

Container PublicAccess

Type:PSPublicAccess
Accepted values:Container, Blob, None
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nazwa grupy zasobów.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RootSquash

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

Type:String
Accepted values:NoRootSquash, RootSquash, AllSquash
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccount

Obiekt konta magazynu

Type:PSStorageAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

Nazwa konta magazynu.

Type:String
Aliases:AccountName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

PSStorageAccount

Dane wyjściowe

PSContainer