Partager via

Set-AzureStorageCORSRule

  • Référence
Module:
Azure.Storage

Définit les règles CORS pour un type de service Stockage.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntax

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

Description

L’applet de commande Set-Azure Stockage CORSRule définit les règles CORS (Cross-Origin Resource Sharing) pour un type de service Stockage Azure. Les types de services de stockage de cette applet de commande sont Blob, Table, File d’attente et Fichier. Cette applet de commande remplace les règles existantes. Pour afficher les règles actuelles, utilisez l’applet de commande Get-Azure Stockage CORSRule.

Exemples

Exemple 1 : Affecter des règles CORS au service d’objets 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

La première commande affecte un tableau de règles à la variable $CorsRules. Cette commande utilise des étendues standard sur plusieurs lignes dans ce bloc de code. La deuxième commande affecte les règles dans $CorsRules au type de service Blob.

Exemple 2 : Modifier les propriétés d’une règle CORS pour le service d’objets 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

La première commande obtient les règles CORS actuelles pour le type d’objet blob à l’aide de l’applet de commande Get-Azure Stockage CORSRule. La commande stocke les règles dans la variable de tableau $CorsRules. Les deuxième et troisième commandes modifient la première règle dans $CorsRules. La commande finale affecte les règles dans $CorsRules au type de service Blob. Les règles révisées remplacent les règles CORS actuelles.

Paramètres

-ClientTimeoutPerRequest

Spécifie l’intervalle de délai d’attente côté client, en secondes, pour une demande de service. Si l’appel précédent échoue dans l’intervalle spécifié, cette applet de commande retente la requête. Si cette applet de commande ne reçoit pas de réponse réussie avant l’expiration de l’intervalle, cette applet de commande retourne une erreur.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Spécifie le nombre maximal d’appels réseau simultanés. Vous pouvez utiliser ce paramètre pour limiter l’accès concurrentiel pour limiter l’utilisation du processeur local et de la bande passante en spécifiant le nombre maximal d’appels réseau simultanés. La valeur spécifiée est un nombre absolu et n’est pas multipliée par le nombre de cœurs. Ce paramètre peut aider à réduire les problèmes de connexion réseau dans des environnements à faible bande passante, tels que 100 kilobits par seconde. La valeur par défaut est 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Spécifie un contexte Stockage Azure. Pour obtenir un contexte, utilisez l’applet de commande New-Azure Stockage Context.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CorsRules

Spécifie un tableau de règles CORS. Vous pouvez récupérer les règles existantes à l’aide de l’applet de commande Get-Azure Stockage CORSRule.

Type:PSCorsRule[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Indique que cette applet de commande retourne une valeur booléenne qui reflète la réussite de l’opération. Par défaut, cette applet de commande ne retourne pas de valeur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Spécifie la durée du délai d’attente pour la partie serveur d’une requête.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceType

Spécifie le type de service Stockage Azure pour lequel cette applet de commande attribue des règles. Les valeurs valides pour ce paramètre sont :

  • Blob
  • Table
  • File d’attente
  • File
Type:StorageServiceType
Accepted values:Blob, Table, Queue, File
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entrées

IStorageContext

Sorties

PSCorsRule