Compartilhar via

Set-AzStorageBlobContent

  • Referência
Módulo:
Az.Storage

Carrega um arquivo local em um blob de Armazenamento do Azure.

Sintaxe

Set-AzStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzStorageBlobContent carrega um arquivo local em um blob de Armazenamento do Azure.

Exemplos

Exemplo 1: Carregar um arquivo nomeado

Set-AzStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Esse comando carrega o arquivo chamado PlanningData em um blob chamado Planning2015.

Exemplo 2: Carregar todos os arquivos na pasta atual

Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -Container "ContosoUploads"

Esse comando usa o cmdlet principal do Windows PowerShell Get-ChildItem para obter todos os arquivos na pasta atual e nas subpastas e, em seguida, os passa para o cmdlet atual usando o operador de pipeline. O cmdlet Set-AzStorageBlobContent carrega os arquivos no contêiner chamado ContosoUploads.

Exemplo 3: Substituir um blob existente

Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"

Esse comando obtém o blob chamado Planning2015 no contêiner ContosoUploads usando o cmdlet Get-AzStorageBlob e, em seguida, passa esse blob para o cmdlet atual. O comando carrega o arquivo chamado ContosoPlanning como Planning2015. Este comando não especifica o parâmetro Force . O comando solicita a confirmação. Se você confirmar o comando, o cmdlet substituirá o blob existente.

Exemplo 4: Carregar um arquivo em um contêiner usando o pipeline

Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Esse comando obtém o contêiner que começa com a cadeia de caracteres ContosoUpload usando o cmdlet Get-AzStorageContainer e, em seguida, passa esse blob para o cmdlet atual. O comando carrega o arquivo chamado ContosoPlanning como Planning2015.

Exemplo 5: Carregar um arquivo no blob de páginas com metadados e PremiumPageBlobTier como P10

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

O primeiro comando cria uma tabela de hash que contém metadados para um blob e armazena essa tabela de hash na variável $Metadata. O segundo comando carrega o arquivo chamado ContosoPlanning para o contêiner chamado ContosoUploads. O blob inclui os metadados armazenados no $Metadata e tem PremiumPageBlobTier como P10.

Exemplo 6: Carregar um arquivo no blob com propriedades de blob especificadas e definir StandardBlobTier como Esporádico

$filepath = "c:\temp\index.html"
Set-AzStorageBlobContent -File $filepath -Container "contosouploads" -Properties @{"ContentType" = [System.Web.MimeMapping]::GetMimeMapping($filepath); "ContentMD5" = "i727sP7HigloQDsqadNLHw=="} -StandardBlobTier Cool

AccountName: storageaccountname, ContainerName: contosouploads

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
index.html           BlockBlob 403116          text/html                      2020-09-22 08:06:53Z Cool                                    False

Esse comando carrega o arquivo c:\temp\index.html para o contêiner chamado contosouploads com propriedades de blob especificadas e define StandardBlobTier como Cool. Esse comando obtém o valor ContentType definido como propriedades de blob pela API [System.Web.MimeMapping]::GetMimeMapping().

Exemplo 7: Carregar um arquivo em um blob com o Escopo de Criptografia

$blob = Set-AzStorageBlobContent  -File "mylocalfile" -Container "mycontainer" -Blob "myblob"  -EncryptionScope "myencryptscope"

$blob.BlobProperties.EncryptionScope

myencryptscope

Esse comando carrega um arquivo em um blob com Escopo de Criptografia.

Parâmetros

-AsJob

Execute o cmdlet em segundo plano.

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

-Blob

Especifica o nome de um blob. Esse cmdlet carrega um arquivo no blob de Armazenamento do Azure especificado por esse parâmetro.

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

-BlobType

Especifica o tipo do blob que esse cmdlet carrega. Os valores aceitáveis para esse parâmetro são:

  • Bloquear
  • Página
  • Acrescentar

O valor padrão é Bloquear.

Tipo:String
Valores aceitos:Block, Page, Append
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClientTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do cliente, em segundos, para uma solicitação de serviço. Se a chamada anterior falhar no intervalo especificado, esse cmdlet repetirá a solicitação. Se esse cmdlet não receber uma resposta bem-sucedida antes do término do intervalo, ele retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CloudBlob

Especifica um objeto CloudBlob . Para obter um objeto CloudBlob , use o cmdlet Get-AzStorageBlob.

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

-CloudBlobContainer

Especifica um objeto CloudBlobContainer da biblioteca de clientes do Armazenamento do Azure. Esse cmdlet carrega o conteúdo em um blob no contêiner especificado por esse parâmetro. Para obter um objeto CloudBlobContainer , use o cmdlet Get-AzStorageContainer.

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

-ConcurrentTaskCount

Especifica o máximo de chamadas de rede simultâneas. Você pode usar esse parâmetro para limitar a simultaneidade para limitar o uso local da CPU e da largura de banda especificando o número máximo de chamadas de rede simultâneas. O valor especificado é uma contagem absoluta e não é multiplicado pela contagem de núcleos. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 kilobits por segundo. O valor padrão é 10.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

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

-Container

Especifica o nome de um contêiner. Esse cmdlet carrega um arquivo em um blob no contêiner especificado por esse parâmetro.

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

-Context

Especifica um contexto de armazenamento do Azure. Para obter um contexto de armazenamento, use o cmdlet New-AzStorageContext. Para usar um contexto de armazenamento criado a partir de um token SAS sem permissão de leitura, é necessário adicionar o parâmetro -Force para ignorar a existência do blob de verificação.

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

-DefaultProfile

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

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

-EncryptionScope

Escopo de criptografia a ser usado ao fazer solicitações para o blob.

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

-File

Especifica um caminho de arquivo local para um arquivo carregar como conteúdo de blob.

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

-Force

Indica que esse cmdlet substitui um blob existente sem solicitar a confirmação.

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

-Metadata

Especifica metadados para o blob carregado.

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

-PremiumPageBlobTier

Camada de Blob de Páginas

Tipo:PremiumPageBlobTier
Valores aceitos:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Properties

Especifica as propriedades do blob carregado. As propriedades com suporte são: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

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

-ServerTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado decorrer antes que o serviço processe a solicitação, o serviço de armazenamento retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StandardBlobTier

Camada de Blob de Blocos, os valores válidos são Frequente/Esporádico/Arquivo/Frio. Veja detalhes em https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

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

-Tag

Marcas de blob

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

-TagCondition

Instrução de expressão de tag opcional para verificar a condição de correspondência. A solicitação de blob falhará quando as marcas de blob não corresponderem à expressão fornecida. Confira os detalhes em https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

CloudBlobContainer

CloudBlob

IStorageContext

Saídas

AzureStorageBlob