Compartir a través de

New-AzStorageContainer

Módulo:
Az.Storage Module

Crea un contenedor de Azure Storage.

Sintaxis

ContainerName (valor predeterminado) 

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

EncryptionScope 

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

Description

El cmdlet New-AzStorageContainer crea un contenedor de Azure Storage.

Ejemplos

Ejemplo 1: Creación de un contenedor de Azure Storage

New-AzStorageContainer -Name "ContainerName" -Permission Off

Este comando crea un contenedor de almacenamiento.

Ejemplo 2: Creación de varios contenedores de Azure Storage

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

En este ejemplo se crean varios contenedores de almacenamiento. Usa el método Split de la clase String de .NET y, a continuación, pasa los nombres en la canalización.

Ejemplo 3: Creación de un contenedor de Azure Storage con ámbito de cifrado

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

$container.BlobContainerProperties.DefaultEncryptionScope
myencryptscope

$container.BlobContainerProperties.PreventEncryptionScopeOverride
True

Este comando crea un contenedor de almacenamiento, con el ámbito de cifrado predeterminado como myencryptscope y evita la carga de blobs con un ámbito de cifrado diferente a este contenedor.

Parámetros

-ClientTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado cliente, en segundos, para una solicitud de servicio. Si se produce un error en la llamada anterior en el intervalo especificado, este cmdlet reintenta la solicitud. Si este cmdlet no recibe una respuesta correcta antes de que transcurre el intervalo, este cmdlet devuelve un error.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ConcurrentTaskCount

Especifica el número máximo de llamadas de red simultáneas. Puede usar este parámetro para limitar la simultaneidad para limitar el uso de ancho de banda y CPU local especificando el número máximo de llamadas de red simultáneas. El valor especificado es un recuento absoluto y no se multiplica por el recuento de núcleos. Este parámetro puede ayudar a reducir los problemas de conexión de red en entornos de ancho de banda bajo, como 100 kilobits por segundo. El valor predeterminado es 10.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Context

Especifica un contexto para el nuevo contenedor.

Propiedades de parámetro

Tipo:IStorageContext
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultEncryptionScope

El contenedor debe usar el ámbito de cifrado especificado para todas las escrituras.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EncryptionScope
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica un nombre para el nuevo contenedor.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:N, Contenedor

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Permission

Especifica el nivel de acceso público a este contenedor. De forma predeterminada, solo el propietario de la cuenta de almacenamiento puede acceder al contenedor y a los blobs de él. Para conceder a los usuarios anónimos permisos de lectura a un contenedor y sus blobs, puede establecer los permisos de contenedor para habilitar el acceso público. Los usuarios anónimos pueden leer blobs en un contenedor disponible públicamente sin autenticar la solicitud. Los valores aceptables para este parámetro son:

  • Contenedor. Proporciona acceso de lectura completo a un contenedor y sus blobs. Los clientes pueden enumerar blobs en el contenedor a través de una solicitud anónima, pero no pueden enumerar contenedores en la cuenta de almacenamiento.
  • Blob. Proporciona acceso de lectura a los datos de blobs en todo un contenedor a través de una solicitud anónima, pero no proporciona acceso a los datos del contenedor. Los clientes no pueden enumerar blobs en el contenedor mediante una solicitud anónima.
  • desactivado. Lo que restringe el acceso solo al propietario de la cuenta de almacenamiento.

Propiedades de parámetro

Tipo:

Nullable<T>[Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType]

Valor predeterminado:None
Valores aceptados:Off, Container, Blob, Unknown
Admite caracteres comodín:False
DontShow:False
Alias:PublicAccess

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PreventEncryptionScopeOverride

Bloquear la invalidación del ámbito de cifrado del valor predeterminado del contenedor.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EncryptionScope
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServerTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado del servicio, en segundos, para una solicitud. Si el intervalo especificado transcurre antes de que el servicio procese la solicitud, el servicio de almacenamiento devuelve un error.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

IStorageContext

Salidas

AzureStorageContainer