Compartilhar via

New-AzStorageContainer

  • Referência
Módulo:
Az.Storage

Cria um contêiner de armazenamento do Azure.

Sintaxe

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

O cmdlet New-AzStorageContainer cria um contêiner de armazenamento do Azure.

Exemplos

Exemplo 1: Criar um contêiner de armazenamento do Azure

New-AzStorageContainer -Name "ContainerName" -Permission Off

Esse comando cria um contêiner de armazenamento.

Exemplo 2: Criar vários contêineres de armazenamento do Azure

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

Este exemplo cria vários contêineres de armazenamento. Ele usa o método Split da classe string do .NET e, em seguida, passa os nomes no pipeline.

Exemplo 3: Criar um contêiner de armazenamento do Azure com o Escopo de Criptografia

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

$container.BlobContainerProperties.DefaultEncryptionScope
myencryptscope

$container.BlobContainerProperties.PreventEncryptionScopeOverride
True

Esse comando cria um contêiner de armazenamento, com Escopo de Criptografia padrão como myencryptscope e upload de blob de prevert com escopo de criptografia diferente para esse contêiner.

Parâmetros

-ClientTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do cliente, em segundos, para uma solicitação de serviço. Se a chamada anterior falhar no intervalo especificado, esse cmdlet repetirá a solicitação. Se esse cmdlet não receber uma resposta bem-sucedida antes que o intervalo se esgote, esse cmdlet retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConcurrentTaskCount

Especifica o máximo de chamadas de rede simultâneas. Você pode usar esse parâmetro para limitar a simultaneidade para limitar o uso local de CPU e largura de banda especificando o número máximo de chamadas de rede simultâneas. O valor especificado é uma contagem absoluta e não é multiplicado pela contagem de núcleos. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 quilobits por segundo. O valor padrão é 10.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Context

Especifica um contexto para o novo contêiner.

Tipo:IStorageContext
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultEncryptionScope

Padrão, o contêiner usará o escopo de criptografia especificado para todas as gravações.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome para o novo contêiner.

Tipo:String
Aliases:N, Container
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Permission

Especifica o nível de acesso público a esse contêiner. Por padrão, o contêiner e todos os blobs nele só podem ser acessados pelo proprietário da conta de armazenamento. Para conceder permissões de leitura de usuários anônimos a um contêiner e seus blobs, você pode definir as permissões de contêiner para habilitar o acesso público. Usuários anônimos podem ler blobs em um contêiner disponível publicamente sem autenticar a solicitação. Os valores aceitáveis para este parâmetro são:

  • Recipiente. Fornece acesso de leitura completo a um contêiner e seus blobs. Os clientes podem enumerar blobs no contêiner por meio de solicitação anônima, mas não podem enumerar contêineres na conta de armazenamento.
  • BLOB. Fornece acesso de leitura aos dados de blob em um contêiner por meio de solicitação anônima, mas não fornece acesso aos dados do contêiner. Os clientes não podem enumerar blobs no contêiner usando solicitação anônima.
  • Desligado. O que restringe o acesso somente ao proprietário da conta de armazenamento.
Tipo:Nullable<T>[BlobContainerPublicAccessType]
Aliases:PublicAccess
Valores aceitos:Off, Container, Blob, Unknown
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreventEncryptionScopeOverride

Bloquear a substituição do escopo de criptografia do padrão do contêiner.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServerTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado ocorrer antes que o serviço processe a solicitação, o serviço de armazenamento retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

IStorageContext

Saídas

AzureStorageContainer