Compartir a través de

Set-AzureStorageCORSRule

  • Referencia
Módulo:
Azure.Storage

Establece las reglas de CORS para un tipo de servicio de almacenamiento.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

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

Description

El cmdlet Set-AzureStorageCORSRule establece las reglas de uso compartido de recursos entre orígenes (CORS) para un tipo de servicio de Azure Storage. Los tipos de servicios de almacenamiento para este cmdlet son Blob, Table, Queue y File. Este cmdlet sobrescribe las reglas existentes. Para ver las reglas actuales, use el cmdlet Get-AzureStorageCORSRule.

Ejemplos

Ejemplo 1: Asignación de reglas de CORS al servicio de blobs

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

El primer comando asigna una matriz de reglas a la variable $CorsRules. Este comando usa la extensión estándar en varias líneas de este bloque de código. El segundo comando asigna las reglas de $CorsRules al tipo blob service.

Ejemplo 2: Cambio de las propiedades de una regla de CORS para Blob Service

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

El primer comando obtiene las reglas CORS actuales para el tipo de blob mediante el cmdlet Get-AzureStorageCORSRule . El comando almacena las reglas en la variable de matriz $CorsRules. Los comandos segundo y tercero modifican la primera regla de $CorsRules. El comando final asigna las reglas de $CorsRules al tipo blob service. Las reglas revisadas sobrescriben las reglas CORS actuales.

Parámetros

-ClientTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado cliente, en segundos, para una solicitud de servicio. Si se produce un error en la llamada anterior en el intervalo especificado, este cmdlet reintenta la solicitud. Si este cmdlet no recibe una respuesta correcta antes de que transcurre el intervalo, este cmdlet devuelve un error.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConcurrentTaskCount

Especifica el número máximo de llamadas de red simultáneas. Puede usar este parámetro para limitar la simultaneidad para limitar el uso de ancho de banda y CPU local especificando el número máximo de llamadas de red simultáneas. El valor especificado es un recuento absoluto y no se multiplica por el recuento de núcleos. Este parámetro puede ayudar a reducir los problemas de conexión de red en entornos de ancho de banda bajo, como 100 kilobits por segundo. El valor predeterminado es 10.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Context

Especifica un contexto de Azure Storage. Para obtener un contexto, use el cmdlet New-AzureStorageContext.

Tipo:IStorageContext
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CorsRules

Especifica una matriz de reglas de CORS. Puede recuperar las reglas existentes mediante el cmdlet Get-AzureStorageCORSRule.

Tipo:PSCorsRule[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Indica que este cmdlet devuelve un valor booleano que refleja el éxito de la operación. De forma predeterminada, este cmdlet no devuelve un valor.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServerTimeoutPerRequest

Especifica el período de tiempo de espera para la parte del servidor de una solicitud.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServiceType

Especifica el tipo de servicio de Azure Storage para el que este cmdlet asigna reglas. Los valores permitidos para este parámetro son los siguientes:

  • Blob
  • Tabla
  • Cola
  • Archivo
Tipo:StorageServiceType
Valores aceptados:Blob, Table, Queue, File
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

IStorageContext

Salidas

PSCorsRule