Partilhar via


Update-AzStorageBlobServiceProperty

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

Sintaxe

AccountName (Predefinição)

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

AccountObject

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

BlobServicePropertiesResourceId

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

Description

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

Exemplos

Exemplo 1: Definir o serviço de 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           :

Este comando define o DefaultServiceVersion do Serviço de 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           :

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

Este comando habilita o controle de versão no serviço Blob de uma conta de armazenamento

Exemplo 4: Atualizar regras 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. Este 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 CORS

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

Este 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 changeFeed em dias. O valor mínimo é de 1 dia e o valor máximo é de 146000 dias (400 anos). Nunca especifique-o quando ativado changeFeed obterá valor nulo nas propriedades do serviço, indica uma retenção infinita do feed de alterações.

Propriedades dos parâmetros

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

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

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

-CorsRule

Especifica regras CORS para o serviço Blob.

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:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, 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

-DefaultServiceVersion

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

Propriedades dos parâmetros

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

-EnableChangeFeed

Habilite Alterar log de feed para a conta de armazenamento definindo como $true, desative Alterar log de feed definindo como $false.

Propriedades dos parâmetros

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

-IsVersioningEnabled

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

Propriedades dos parâmetros

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

-ResourceGroupName

Nome do Grupo de Recursos.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

AccountName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceId

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

BlobServicePropertiesResourceId
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-StorageAccount

Objeto da conta de armazenamento

Propriedades dos parâmetros

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

Conjuntos de parâmetros

AccountObject
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageAccountName

Nome da conta de armazenamento.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome da Conta, Nome

Conjuntos de parâmetros

AccountName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

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

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

PSStorageAccount

String

Saídas

PSBlobServiceProperties