Set-AzureStorageCORSRule

  • Referência
Módulo:
Azure.Storage

Define as regras CORS para um tipo de serviço de armazenamento.

Aviso

O módulo do PowerShell do AzureRM foi oficialmente preterido em 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 é mais mantido ou suportado, 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-AzureStorageCORSRule
   [-ServiceType] <StorageServiceType>
   -CorsRules <PSCorsRule[]>
   [-PassThru]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureStorageCORSRule define as regras de CORS (Cross-Origin Resource Sharing) para um tipo de serviço de Armazenamento do Azure. Os tipos de serviços de armazenamento para esse cmdlet são Blob, Tabela, Fila e Arquivo. Esse cmdlet substitui as regras existentes. Para ver as regras atuais, use o cmdlet Get-AzureStorageCORSRule.

Exemplos

Exemplo 1: Atribuir regras CORS ao serviço de blob

PS C:\>$CorsRules = (@{
    AllowedHeaders=@("x-ms-blob-content-type","x-ms-blob-content-disposition");
    AllowedOrigins=@("*");
    MaxAgeInSeconds=30;
    AllowedMethods=@("Get","Connect")},
    @{
    AllowedOrigins=@("http://www.fabrikam.com","http://www.contoso.com"); 
    ExposedHeaders=@("x-ms-meta-data*","x-ms-meta-customheader"); 
    AllowedHeaders=@("x-ms-meta-target*","x-ms-meta-customheader");
    MaxAgeInSeconds=30;
    AllowedMethods=@("Put")})
PS C:\> Set-AzureStorageCORSRule -ServiceType Blob -CorsRules $CorsRules

O primeiro comando atribui uma matriz de regras à variável $CorsRules. Este comando usa extensões padrão em várias linhas neste bloco de código. O segundo comando atribui as regras em $CorsRules ao tipo de serviço Blob.

Exemplo 2: Alterar propriedades de uma regra CORS para o serviço de blob

PS C:\>$CorsRules = Get-AzureStorageCORSRule -ServiceType Blob
PS C:\> $CorsRules[0].AllowedHeaders = @("x-ms-blob-content-type", "x-ms-blob-content-disposition")
PS C:\> $CorsRules[0].AllowedMethods = @("Get", "Connect", "Merge")
PS C:\> Set-AzureStorageCORSRule -ServiceType Blob -CorsRules $CorsRules

O primeiro comando obtém as regras CORS atuais para o tipo Blob usando o cmdlet Get-AzureStorageCORSRule . O comando armazena as regras na variável de matriz $CorsRules. O segundo e o terceiro comandos modificam a primeira regra em $CorsRules. O comando final atribui as regras em $CorsRules ao tipo de serviço Blob. As regras revisadas substituem as regras CORS atuais.

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 esse cmdlet não receber uma resposta bem-sucedida antes que o intervalo transcorra, 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 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.

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 de Armazenamento do Azure. Para obter um contexto, use 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

-CorsRules

Especifica uma matriz de regras CORS. Você pode recuperar as regras existentes usando o cmdlet Get-AzureStorageCORSRule.

Tipo:PSCorsRule[]
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 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

-PassThru

Indica que esse cmdlet retorna um Boolean que reflete o sucesso da operação. Por padrão, esse cmdlet não retorna um valor.

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

-ServerTimeoutPerRequest

Especifica a duração do período de tempo limite para a parte do servidor de uma 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

-ServiceType

Especifica o tipo de serviço de Armazenamento do Azure ao qual este cmdlet atribui regras. Os valores aceitáveis para esse parâmetro são:

  • Blob
  • Table
  • Fila
  • Arquivo
Tipo:StorageServiceType
Valores aceitos:Blob, Table, Queue, File
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

IStorageContext

Saídas

PSCorsRule