Compartilhar via


New-AzStorageContainer

Cria um contêiner de armazenamento do Azure.

Sintaxe

ContainerName (Padrã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

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 .NET String 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 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 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.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ClientTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Context

Especifica um contexto para o novo contêiner.

Propriedades do parâmetro

Tipo:IStorageContext
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultEncryptionScope

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EncryptionScope
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica um nome para o novo contêiner.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:N, Contêiner

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.
  • Desativado O que restringe o acesso somente ao proprietário da conta de armazenamento.

Propriedades do parâmetro

Tipo:

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

Valor padrão:None
Valores aceitos:Off, Container, Blob, Unknown
Dá suporte a curingas:False
DontShow:False
Aliases:PublicAccess

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PreventEncryptionScopeOverride

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EncryptionScope
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ServerTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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