Delen via

New-AzStorageContainer

  • Referentie
Module:
Az.Storage

Hiermee wordt een Azure-opslagcontainer gemaakt.

Syntaxis

New-AzStorageContainer
   [-Name] <String>
   [[-Permission] <BlobContainerPublicAccessType>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
New-AzStorageContainer
   [-Name] <String>
   [[-Permission] <BlobContainerPublicAccessType>]
   -DefaultEncryptionScope <String>
   -PreventEncryptionScopeOverride <Boolean>
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

Met de cmdlet New-AzStorageContainer wordt een Azure-opslagcontainer gemaakt.

Voorbeelden

Voorbeeld 1: Een Azure Storage-container maken

New-AzStorageContainer -Name "ContainerName" -Permission Off

Met deze opdracht maakt u een opslagcontainer.

Voorbeeld 2: Meerdere Azure Storage-containers maken

"container1 container2 container3".split() | New-AzStorageContainer -Permission Container

In dit voorbeeld worden meerdere opslagcontainers gemaakt. Hierbij wordt de splitsmethode van de klasse .NET String gebruikt en worden de namen vervolgens doorgegeven aan de pijplijn.

Voorbeeld 3: Een Azure-opslagcontainer maken met versleutelingsbereik

$container = New-AzStorageContainer  -Name "mycontainer" -DefaultEncryptionScope "myencryptscope" -PreventEncryptionScopeOverride $true 

$container.BlobContainerProperties.DefaultEncryptionScope
myencryptscope

$container.BlobContainerProperties.PreventEncryptionScopeOverride
True

Met deze opdracht maakt u een opslagcontainer met standaardversleutelingsbereik als myencryptscope en maakt u blobupload vooraf met een ander versleutelingsbereik naar deze container.

Parameters

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

Type:Nullable<T>[Int32]
Aliassen:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Hiermee geeft u een context voor de nieuwe container.

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultEncryptionScope

Standaard gebruikt de container een opgegeven versleutelingsbereik voor alle schrijfbewerkingen.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een naam op voor de nieuwe container.

Type:String
Aliassen:N, Container
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Permission

Hiermee geeft u het niveau van openbare toegang tot deze container. De container en eventuele blobs in de container kunnen standaard alleen worden geopend door de eigenaar van het opslagaccount. Als u anonieme gebruikers leesmachtigingen wilt verlenen aan een container en de bijbehorende blobs, kunt u de containermachtigingen instellen om openbare toegang in te schakelen. Anonieme gebruikers kunnen blobs lezen in een openbaar beschikbare container zonder de aanvraag te verifiëren. De aanvaardbare waarden voor deze parameter zijn:

  • Container. Biedt volledige leestoegang tot een container en de bijbehorende blobs. Clients kunnen blobs in de container opsommen via anonieme aanvragen, maar kunnen geen containers in het opslagaccount opsommen.
  • Blob. Biedt leestoegang tot blobgegevens in een container via anonieme aanvraag, maar biedt geen toegang tot containergegevens. Clients kunnen geen blobs in de container opsommen met behulp van anonieme aanvragen.
  • Uit. Hiermee wordt de toegang beperkt tot alleen de eigenaar van het opslagaccount.
Type:Nullable<T>[BlobContainerPublicAccessType]
Aliassen:PublicAccess
Geaccepteerde waarden:Off, Container, Blob, Unknown
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PreventEncryptionScopeOverride

Blokkeer onderdrukking van versleutelingsbereik van de standaardcontainer.

Type:Boolean
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServerTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de servicezijde op, in seconden, voor een aanvraag. Als het opgegeven interval is verstreken voordat de service de aanvraag verwerkt, retourneert de opslagservice een fout.

Type:Nullable<T>[Int32]
Aliassen:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

IStorageContext

Uitvoerwaarden

AzureStorageContainer