Freigeben über

New-AzStorageContainer

  • Referenz
Modul:
Az.Storage

Erstellt einen Azure-Speichercontainer.

Syntax

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

Beschreibung

Das Cmdlet New-AzStorageContainer erstellt einen Azure-Speichercontainer.

Beispiele

Beispiel 1: Erstellen eines Azure-Speichercontainers

New-AzStorageContainer -Name "ContainerName" -Permission Off

Mit diesem Befehl wird ein Speichercontainer erstellt.

Beispiel 2: Erstellen mehrerer Azure-Speichercontainer

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

In diesem Beispiel werden mehrere Speichercontainer erstellt. Sie verwendet die Split-Methode der .NET String-Klasse und übergibt dann die Namen in der Pipeline.

Beispiel 3: Erstellen eines Azure-Speichercontainers mit Verschlüsselungsbereich

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

$container.BlobContainerProperties.DefaultEncryptionScope
myencryptscope

$container.BlobContainerProperties.PreventEncryptionScopeOverride
True

Dieser Befehl erstellt einen Speichercontainer mit standardverschlüsselungsbereich als myencryptscope und prevert blob upload with different Encryption Scope to this container.

Parameter

-ClientTimeoutPerRequest

Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.

Typ:Nullable<T>[Int32]
Aliase:ClientTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConcurrentTaskCount

Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert lautet 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Context

Gibt einen Kontext für den neuen Container an.

Typ:IStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultEncryptionScope

Standardmäßig verwendet der Container den angegebenen Verschlüsselungsbereich für alle Schreibvorgänge.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für den neuen Container an.

Typ:String
Aliase:N, Container
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Permission

Gibt die Ebene des öffentlichen Zugriffs auf diesen Container an. Standardmäßig kann auf den Container und alle darin enthaltenen Blobs nur vom Besitzer des Speicherkontos zugegriffen werden. Um anonymen Benutzern Leseberechtigungen für einen Container und seine Blobs zu gewähren, können Sie die Containerberechtigungen so festlegen, dass der öffentliche Zugriff aktiviert wird. Anonyme Benutzer können Blobs in einem öffentlich verfügbaren Container lesen, ohne die Anforderung zu authentifizieren. Zulässige Werte für diesen Parameter:

  • Container: Bietet volllesezugriff auf einen Container und seine Blobs. Clients können Blobs im Container über anonyme Anforderung aufzählen, container jedoch nicht im Speicherkonto aufzählen.
  • Blob. Bietet Lesezugriff auf BLOB-Daten in einem Container über anonyme Anforderung, bietet jedoch keinen Zugriff auf Containerdaten. Clients können Blobs im Container nicht mithilfe einer anonymen Anforderung aufzählen.
  • Deaktiviert. Dies schränkt den Zugriff nur auf den Besitzer des Speicherkontos ein.
Typ:Nullable<T>[BlobContainerPublicAccessType]
Aliase:PublicAccess
Zulässige Werte:Off, Container, Blob, Unknown
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PreventEncryptionScopeOverride

Blockieren der Außerkraftsetzung des Verschlüsselungsbereichs vom Containerstandard.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerTimeoutPerRequest

Gibt das Dienstseitige Timeoutintervall in Sekunden für eine Anforderung an. Wenn das angegebene Intervall verstrichen ist, bevor der Dienst die Anforderung verarbeitet, gibt der Speicherdienst einen Fehler zurück.

Typ:Nullable<T>[Int32]
Aliase:ServerTimeoutPerRequestInSeconds
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

IStorageContext

Ausgaben

AzureStorageContainer