Partager via

New-AzStorageContainer

  • Référence
Module:
Az.Storage

Crée un conteneur de stockage Azure.

Syntaxe

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

L’applet de commande New-AzStorageContainer crée un conteneur de stockage Azure.

Exemples

Exemple 1 : Créer un conteneur de stockage Azure

New-AzStorageContainer -Name "ContainerName" -Permission Off

Cette commande crée un conteneur de stockage.

Exemple 2 : Créer plusieurs conteneurs de stockage Azure

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

Cet exemple crée plusieurs conteneurs de stockage. Il utilise la méthode Split de la classe .NET String , puis transmet les noms sur le pipeline.

Exemple 3 : Créer un conteneur de stockage Azure avec étendue de chiffrement

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

$container.BlobContainerProperties.DefaultEncryptionScope
myencryptscope

$container.BlobContainerProperties.PreventEncryptionScopeOverride
True

Cette commande crée un conteneur de stockage, avec l’étendue de chiffrement par défaut en tant que myencryptscope, et prévertit le chargement d’objets blob avec une étendue de chiffrement différente sur ce conteneur.

Paramètres

-ClientTimeoutPerRequest

Spécifie l’intervalle de délai d’attente côté client, en secondes, pour une demande de service. Si l’appel précédent échoue dans l’intervalle spécifié, cette applet de commande retente la requête. Si cette applet de commande ne reçoit pas de réponse réussie avant l’expiration de l’intervalle, cette applet de commande retourne une erreur.

Type:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConcurrentTaskCount

Spécifie le nombre maximal d’appels réseau simultanés. Vous pouvez utiliser ce paramètre pour limiter l’accès concurrentiel pour limiter l’utilisation du processeur local et de la bande passante en spécifiant le nombre maximal d’appels réseau simultanés. La valeur spécifiée est un nombre absolu et n’est pas multipliée par le nombre de cœurs. Ce paramètre peut aider à réduire les problèmes de connexion réseau dans des environnements à faible bande passante, tels que 100 kilobits par seconde. La valeur par défaut est 10.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Context

Spécifie un contexte pour le nouveau conteneur.

Type:IStorageContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultEncryptionScope

Par défaut, le conteneur doit utiliser l’étendue de chiffrement spécifiée pour toutes les écritures.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un nom pour le nouveau conteneur.

Type:String
Alias:N, Container
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Permission

Spécifie le niveau d’accès public à ce conteneur. Par défaut, le conteneur et tous les objets blob qu’il contient sont accessibles uniquement par le propriétaire du compte de stockage. Pour accorder des autorisations de lecture anonymes aux utilisateurs à un conteneur et à ses objets blob, vous pouvez définir les autorisations de conteneur pour activer l’accès public. Les utilisateurs anonymes peuvent lire des objets blob dans un conteneur disponible publiquement sans authentifier la requête. Les valeurs valides pour ce paramètre sont :

  • Conteneur : Fournit un accès en lecture complet à un conteneur et à ses objets blob. Les clients peuvent énumérer des objets blob dans le conteneur par le biais d’une demande anonyme, mais ne peuvent pas énumérer les conteneurs dans le compte de stockage.
  • BLOB. Fournit un accès en lecture aux données d’objet blob dans un conteneur par le biais d’une requête anonyme, mais ne fournit pas l’accès aux données de conteneur. Les clients ne peuvent pas énumérer les objets blob dans le conteneur à l’aide d’une requête anonyme.
  • Désactivé. Ce qui limite l’accès au propriétaire du compte de stockage uniquement.
Type:Nullable<T>[BlobContainerPublicAccessType]
Alias:PublicAccess
Valeurs acceptées:Off, Container, Blob, Unknown
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PreventEncryptionScopeOverride

Bloquer le remplacement de l’étendue de chiffrement par défaut du conteneur.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerTimeoutPerRequest

Spécifie l’intervalle de délai d’expiration côté service, en secondes, pour une demande. Si l’intervalle spécifié s’écoule avant que le service traite la requête, le service de stockage retourne une erreur.

Type:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

IStorageContext

Sorties

AzureStorageContainer