Compartilhar via


Update-AzStorageBlobServiceProperty

Modifica as propriedades de serviço para o serviço de Blob de Armazenamento do Azure.

Sintaxe

Update-AzStorageBlobServiceProperty
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      [-DefaultServiceVersion <String>]
      [-EnableChangeFeed <Boolean>]
      [-ChangeFeedRetentionInDays <Int32>]
      [-IsVersioningEnabled <Boolean>]
      [-CorsRule <PSCorsRule[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzStorageBlobServiceProperty
      -StorageAccount <PSStorageAccount>
      [-DefaultServiceVersion <String>]
      [-EnableChangeFeed <Boolean>]
      [-ChangeFeedRetentionInDays <Int32>]
      [-IsVersioningEnabled <Boolean>]
      [-CorsRule <PSCorsRule[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzStorageBlobServiceProperty
      [-ResourceId] <String>
      [-DefaultServiceVersion <String>]
      [-EnableChangeFeed <Boolean>]
      [-ChangeFeedRetentionInDays <Int32>]
      [-IsVersioningEnabled <Boolean>]
      [-CorsRule <PSCorsRule[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Update-AzStorageBlobServiceProperty do modifica as propriedades de serviço para o serviço de Blob de Armazenamento do Azure.

Exemplos

Exemplo 1: Definir o serviço blob DefaultServiceVersion como 2018-03-28

Update-AzStorageBlobServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -DefaultServiceVersion 2018-03-28

StorageAccountName            : mystorageaccount
ResourceGroupName             : myresourcegroup
DefaultServiceVersion         : 2018-03-28
DeleteRetentionPolicy.Enabled : False
DeleteRetentionPolicy.Days    : 
RestorePolicy.Enabled         : 
RestorePolicy.Days            : 
ChangeFeed.Enabled            : 
ChangeFeed.RetentionInDays    :
IsVersioningEnabled           :

Esse comando define o DefaultServiceVersion do Serviço blob como 2018-03-28.

Exemplo 2: Habilitar o Changefeed no serviço Blob de uma conta de Armazenamento com ChangeFeedRetentionInDays como 5 dias

Update-AzStorageBlobServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -EnableChangeFeed $true -ChangeFeedRetentionInDays 5

StorageAccountName            : mystorageaccount
ResourceGroupName             : myresourcegroup
DefaultServiceVersion         : 
DeleteRetentionPolicy.Enabled : False
DeleteRetentionPolicy.Days    : 
RestorePolicy.Enabled         : 
RestorePolicy.Days            : 
ChangeFeed.Enabled            : True
ChangeFeed.RetentionInDays    : 5
IsVersioningEnabled           :

Esse comando habilita o Changefeed no serviço Blob de uma conta de Armazenamento com ChangeFeedRetentionInDays como 5 dias. O suporte ao feed de alterações no Armazenamento de Blobs do Azure funciona ouvindo uma conta de Armazenamento de Blobs ou GPv2 para qualquer evento de criação, modificação ou exclusão no nível de blob. Em seguida, ele gera um log ordenado de eventos para os blobs armazenados no contêiner de $blobchangefeed dentro da conta de armazenamento. As alterações serializadas são mantidas como um arquivo Apache Avro e podem ser processadas de forma assíncrona e incremental. Se não especificar ChangeFeedRetentionInDays, obterá valor nulo em propriedades de serviço, indica uma retenção infinita do feed de alterações.

Exemplo 3: habilitar o controle de versão no serviço blob de uma conta de armazenamento

Update-AzStorageBlobServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -IsVersioningEnabled $true

StorageAccountName            : mystorageaccount
ResourceGroupName             : myresourcegroup
DefaultServiceVersion         : 
DeleteRetentionPolicy.Enabled : False
DeleteRetentionPolicy.Days    : 
RestorePolicy.Enabled         : 
RestorePolicy.Days            : 
ChangeFeed                    : 
ChangeFeed.RetentionInDays    :
IsVersioningEnabled           : True

Esse comando habilita o controle de versão no serviço Blob de uma conta de Armazenamento

Exemplo 4: Atualizar regras do CORS

$CorsRules = (@{
    AllowedHeaders=@("x-ms-blob-content-type","x-ms-blob-content-disposition");
    ExposedHeaders=@(); 
    AllowedOrigins=@("*");
    AllowedMethods=@("TRACE","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")})

$property = Update-AzStorageBlobServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule $CorsRules
$property.Cors.CorsRulesProperty

AllowedOrigins  : {*}
AllowedMethods  : {TRACE, CONNECT}
MaxAgeInSeconds : 0
ExposedHeaders  : {}
AllowedHeaders  : {x-ms-blob-content-type, x-ms-blob-content-disposition}

AllowedOrigins  : {http://www.fabrikam.com, http://www.contoso.com}
AllowedMethods  : {PUT}
MaxAgeInSeconds : 30
ExposedHeaders  : {x-ms-meta-customheader, x-ms-meta-data*}
AllowedHeaders  : {x-ms-meta-customheader, x-ms-meta-target*}

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

Exemplo 5: Limpar regras do CORS

Update-AzStorageBlobServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule @()

Esse comando limpa as regras CORS de uma conta de Armazenamento inserindo @() no parâmetro CorsRule

Parâmetros

-ChangeFeedRetentionInDays

Indica a duração da retenção do changeFeed em dias. O valor mínimo é de 1 dia e o valor máximo é de 146000 dias (400 anos). Nunca especifique-o quando o changeFeed habilitado obterá valor nulo nas propriedades do serviço, indicando uma retenção infinita do feed de alterações.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-CorsRule

Especifica regras CORS para o serviço Blob.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultServiceVersion

Versão de serviço padrão a ser definida

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

-EnableChangeFeed

Habilite o registro em log do Feed de Alterações para a conta de armazenamento definido como $true, desabilite o registro em log do Feed de Alterações definido como $false.

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

-IsVersioningEnabled

Obtém ou define que o controle de versão será habilitado se definido como true.

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

-ResourceGroupName

Nome do Grupo de Recursos.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceId

Insira uma ID de recurso de conta de armazenamento ou uma ID de recurso de propriedades do serviço Blob.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StorageAccount

Objeto da conta de armazenamento

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

-StorageAccountName

Nome da conta de armazenamento.

Tipo:String
Aliases:AccountName, Name
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

PSStorageAccount

String

Saídas

PSBlobServiceProperties