Compartilhar via


Set-AzureStorageContainerAcl

Define a permissão de acesso público para um contêiner de armazenamento.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Set-AzureStorageContainerAcl
   [-Name] <String>
   [-Permission] <BlobContainerPublicAccessType>
   [-PassThru]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureStorageContainerAcl define a permissão de acesso público para o contêiner de armazenamento especificado no Azure.

Exemplos

Exemplo 1: Definir a ACL do contêiner de armazenamento do Azure por nome

PS C:\>Set-AzureStorageContainerAcl -Container "Container01" -Permission Off -PassThru

Esse comando cria um contêiner que não tem acesso público.

Exemplo 2: Definir a ACL do contêiner de armazenamento do Azure usando o pipeline

PS C:\>Get-AzureStorageContainer container* | Set-AzureStorageContainerAcl -Permission Blob -PassThru

Esse comando obtém todos os contêineres de armazenamento cujo nome começa com contêiner e, em seguida, passa o resultado no pipeline para definir a permissão para todos eles como acesso ao Blob.

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 do término do intervalo, ele retornará um erro.

Tipo:Nullable<T>[Int32]
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 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 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 kilobits 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 o contexto de armazenamento do Azure. Você pode criá-lo usando o cmdlet New-AzureStorageContext.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a 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 de 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

-PassThru

Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
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 podem ser acessados somente pelo proprietário da conta de armazenamento. Para conceder permissões de leitura a 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. 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 esse parâmetro são: --Container. 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. Restringe o acesso apenas ao proprietário da conta de armazenamento.

Tipo:BlobContainerPublicAccessType
Aliases:PublicAccess
Valores aceitos:Off, Container, Blob, Unknown
Cargo:1
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 decorrer antes que o serviço processe a solicitação, o serviço de armazenamento retornará um erro. Tempo limite do lado do servidor para cada solicitação.

Tipo:Nullable<T>[Int32]
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