Partilhar via

New-AzStorageContainer

Módulo:
Az.Storage Module

Cria um contêiner de armazenamento do Azure.

Sintaxe

ContainerName (Predefinição) 

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

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

Este 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 .NET String e, em seguida, passa os nomes no pipeline.

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

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

$container.BlobContainerProperties.DefaultEncryptionScope
myencryptscope

$container.BlobContainerProperties.PreventEncryptionScopeOverride
True

Este comando cria um contêiner de armazenamento, com Escopo de Criptografia padrão como myencryptscope, e impede o upload de blob 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 tentará novamente a solicitação. Se este cmdlet não receber uma resposta bem-sucedida antes do intervalo passar, ele retornará um erro.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ClientTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 da CPU e da 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 principal. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 kilobits por segundo. O valor padrão é 10.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Context

Especifica um contexto para o novo contêiner.

Propriedades dos parâmetros

Tipo:IStorageContext
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultEncryptionScope

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

EncryptionScope
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica um nome para o novo contêiner.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:N, Container

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Permission

Especifica o nível de acesso público a esse contêiner. Por padrão, o contêiner e quaisquer blobs nele podem ser acessados apenas pelo proprietário da conta de armazenamento. Para conceder permissões de leitura a usuários anônimos para um contêiner e seus blobs, você pode definir as permissões de contêiner para habilitar o acesso público. Os 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:

  • Contentor. Fornece acesso de leitura total 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 a dados de blob em todo um contêiner por meio de solicitação anônima, mas não fornece acesso a dados de contêiner. Os clientes não podem enumerar blobs no contêiner usando solicitação anônima.
  • Desligado. O que restringe o acesso apenas ao proprietário da conta de armazenamento.

Propriedades dos parâmetros

Tipo:

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

Default value:None
Valores aceites:Off, Container, Blob, Unknown
Suporta carateres universais:False
NãoMostrar:False
Aliases:Acesso Público

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PreventEncryptionScopeOverride

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

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

EncryptionScope
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ServerTimeoutPerRequest

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

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ServerTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

IStorageContext

Saídas

AzureStorageContainer