Sdílet prostřednictvím


New-AzRmStorageContainer

Vytvoří kontejner objektů blob služby Storage.

Syntaxe

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

Description

Rutina New-AzRmStorageContainer vytvoří kontejner objektů blob úložiště.

Příklady

Příklad 1: Vytvoření kontejneru objektů blob úložiště s názvem účtu úložiště a názvem kontejneru s metadaty

New-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" -Metadata @{tag0="value0";tag1="value1";tag2="value2"}

Tento příkaz vytvoří kontejner objektů blob úložiště s názvem účtu úložiště a názvem kontejneru s metadaty.

Příklad 2: Vytvoření kontejneru objektů blob úložiště s objektem účtu úložiště a názvem kontejneru s veřejným přístupem jako objektem blob

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount"
New-AzRmStorageContainer -StorageAccount $accountObject -ContainerName "myContainer" -PublicAccess Blob

Tento příkaz vytvoří kontejner objektů blob úložiště s objektem účtu úložiště a názvem kontejneru s veřejným přístupem jako objektem blob.

Příklad 3: Vytvoření kontejneru úložiště s nastavením 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

Tento příkaz vytvoří kontejner úložiště s defalt encryptionScope a blokuje přepsání oboru šifrování z výchozího kontejneru. Pak zobrazte související vlastnosti kontejneru.

Příklad 4: Vytvoření kontejneru úložiště Azure pomocí RootSquash

$container = New-AzRmStorageContainer -ResourceGroupName "myersourcegroup" -AccountName "mystorageaccount" -Name "mycontainer" -RootSquash AllSquash

$container.EnableNfsV3AllSquash
True

$container.EnableNfsV3RootSquash
False

Tento příkaz vytvoří kontejner úložiště s vlastností RootSquash nastavenou jako AllSquash. RootSquash funguje jenom u účtu úložiště, který povolil NfsV3.

Příklad 5: Vytvoření kontejneru úložiště a povolení neměnného úložiště s využitím správy verzí

$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

Tento příkaz vytvoří kontejner úložiště a povolí neměnné úložiště pomocí správy verzí. Příkaz funguje jenom v případech, kdy už účet úložiště povolil správu verzí objektů blob.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultEncryptionScope

Ve výchozím nastavení kontejner použije zadaný obor šifrování pro všechny zápisy.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableImmutableStorageWithVersioning

Povolte neměnné úložiště s verzí na úrovni kontejneru.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Metadata

Metadata kontejneru

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Název kontejneru

Typ:String
Aliasy:N, ContainerName
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PreventEncryptionScopeOverride

Blokování přepsání oboru šifrování z výchozího kontejneru

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PublicAccess

Container PublicAccess

Typ:PSPublicAccess
Přípustné hodnoty:Container, Blob, None
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Název skupiny prostředků

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RootSquash

Nastaví snížení přístupových práv pro vzdáleného superuživatele. Mezi možné hodnoty patří: NoRootSquash, RootSquash, AllSquash.

Typ:String
Přípustné hodnoty:NoRootSquash, RootSquash, AllSquash
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-StorageAccount

Objekt účtu úložiště

Typ:PSStorageAccount
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-StorageAccountName

Název účtu úložiště

Typ:String
Aliasy:AccountName
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

PSStorageAccount

Výstupy

PSContainer