Set-AzStorageCORSRule

Ustawia reguły CORS dla typu usługi Storage.

Składnia

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

Opis

Polecenie cmdlet Set-AzStorageCORSRule ustawia reguły współużytkowania zasobów między źródłami (CORS) dla typu usługi Azure Storage. Typy usług magazynu dla tego polecenia cmdlet to Blob, Table, Queue i File. To polecenie cmdlet zastępuje istniejące reguły. Aby wyświetlić bieżące reguły, użyj polecenia cmdlet Get-AzStorageCORSRule.

Przykłady

Przykład 1. Przypisywanie reguł CORS do usługi obiektów 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

Pierwsze polecenie przypisuje tablicę reguł do zmiennej $CorsRules. To polecenie używa standardu rozciąga się na kilka wierszy w tym bloku kodu. Drugie polecenie przypisuje reguły w $CorsRules do typu usługi Blob.

Przykład 2. Zmienianie właściwości reguły CORS dla usługi 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

Pierwsze polecenie pobiera bieżące reguły CORS dla typu obiektu blob przy użyciu polecenia cmdlet Get-AzStorageCORSRule . Polecenie przechowuje reguły w zmiennej tablicy $CorsRules. Drugie i trzecie polecenia modyfikują pierwszą regułę w $CorsRules. Ostatnie polecenie przypisuje reguły w $CorsRules do typu usługi Blob. Poprawione reguły zastępują bieżące reguły CORS.

Parametry

-ClientTimeoutPerRequest

Określa interwał limitu czasu po stronie klienta w sekundach dla jednego żądania obsługi. Jeśli poprzednie wywołanie zakończy się niepowodzeniem w określonym interwale, to polecenie cmdlet ponawia próbę żądania. Jeśli to polecenie cmdlet nie otrzyma pomyślnej odpowiedzi przed upływem interwału, to polecenie cmdlet zwróci błąd.

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

-ConcurrentTaskCount

Określa maksymalne współbieżne wywołania sieciowe. Tego parametru można użyć, aby ograniczyć współbieżność w celu ograniczenia użycia lokalnego procesora CPU i przepustowości, określając maksymalną liczbę współbieżnych wywołań sieciowych. Określona wartość jest liczbą bezwzględną i nie jest mnożona przez liczbę rdzeni. Ten parametr może pomóc w zmniejszeniu problemów z połączeniem sieciowym w środowiskach o niskiej przepustowości, takich jak 100 kilobitów na sekundę. Wartość domyślna to 10.

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

-Context

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst, użyj polecenia cmdlet New-AzStorageContext.

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

-CorsRules

Określa tablicę reguł CORS. Istniejące reguły można pobrać przy użyciu polecenia cmdlet Get-AzStorageCORSRule.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-PassThru

Wskazuje, że to polecenie cmdlet zwraca wartość logiczną, która odzwierciedla powodzenie operacji. Domyślnie to polecenie cmdlet nie zwraca wartości.

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

-ServerTimeoutPerRequest

Określa długość limitu czasu dla części żądania serwera.

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

-ServiceType

Określa typ usługi Azure Storage, dla którego to polecenie cmdlet przypisuje reguły. Dopuszczalne wartości tego parametru to:

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

Dane wejściowe

IStorageContext

Dane wyjściowe

PSCorsRule