Partilhar via


Set-AzStorageCORSRule

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

Sintaxe

Default (Predefinição)

Set-AzStorageCORSRule
    [-ServiceType] <StorageServiceType>
    -CorsRules <PSCorsRule[]>
    [-PassThru]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Description

O cmdlet Set-AzStorageCORSRule define as regras de Partilha de Recursos de Origem Cruzada (CORS) para um tipo de serviço Armazenamento do Azure. Os tipos de serviços de armazenamento para este cmdlet são Blob, Tabela, Fila e Arquivo. Este cmdlet substitui as regras existentes. Para ver as regras atuais, use o cmdlet Get-AzStorageCORSRule.

Exemplos

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

$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")})

Set-AzStorageCORSRule -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 serviço de blob

$CorsRules = Get-AzStorageCORSRule -ServiceType Blob
$CorsRules[0].AllowedHeaders = @("x-ms-blob-content-type", "x-ms-blob-content-disposition")
$CorsRules[0].AllowedMethods = @("Get", "Connect", "Merge")
Set-AzStorageCORSRule -ServiceType Blob -CorsRules $CorsRules

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

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 predefinido é 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 do Armazenamento do Azure. Para obter um contexto, use o cmdlet New-AzStorageContext .

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

-CorsRules

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

Propriedades dos parâmetros

Tipo:

PSCorsRule[]

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

Conjuntos de parâmetros

(All)
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, conta, inquilino e subscrição 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

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

Propriedades dos parâmetros

Tipo:SwitchParameter
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

-ServerTimeoutPerRequest

Especifica o período de tempo limite para a parte do servidor de uma solicitação.

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

-ServiceType

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

  • Blob
  • Table
  • Fila
  • Ficheiro

Propriedades dos parâmetros

Tipo:StorageServiceType
Default value:None
Valores aceites:Blob, Table, Queue, File
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
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

IStorageContext

Saídas

PSCorsRule