Compartilhar via

Set-AzStorageBlobContent

  • Referência
Módulo:
Az.Storage

Carrega um arquivo local em um blob do 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 em subpastas e, em seguida, passá-los para o cmdlet atual usando o operador de pipeline. O cmdlet Set-AzStorageBlobContent carrega os arquivos para o 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. Esse 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 em $Metadata e tem PremiumPageBlobTier como P10.

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

$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 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 para o blob do 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 para o blob que este cmdlet carrega. Os valores aceitáveis para este 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 que o intervalo se esgote, esse cmdlet 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 do Cliente de Armazenamento do Azure. Esse cmdlet carrega 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 de CPU e 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 quilobits 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 a 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 -Force parâmetro 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 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 ser carregado 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 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 ocorrer 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 Hot/Cool/Archive/Cold. Veja detalhes em https://zcusa.951200.xyz/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 marca 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. Veja os detalhes em https://zcusa.951200.xyz/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