Partilhar via

Set-AzStorageBlobContent

Módulo:
Az.Storage Module

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

Sintaxe

SendManual (Predefinição) 

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>]

ContainerPipeline 

Set-AzStorageBlobContent
    [-File] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-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>]

BlobPipeline 

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 ficheiro nomeado

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

Este comando carrega o arquivo chamado PlanningData para um blob chamado Planning2015.

Exemplo 2: Carregar todos os arquivos na pasta atual

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

Este comando usa o cmdlet principal do Windows PowerShell Get-ChildItem para obter todos os arquivos na pasta atual e em 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"

Este 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 para um contêiner usando o pipeline

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

Este 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 para blob de página 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 no contêiner chamado ContosoUploads. O blob inclui os metadados armazenados no $Metadata e tem PremiumPageBlobTier como P10.

Exemplo 6: Carregue um arquivo para blob com propriedades de blob especificadas e defina 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

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

Exemplo 7: Carregar um arquivo para um blob com escopo de criptografia

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

$blob.BlobProperties.EncryptionScope

myencryptscope

Este comando carrega um arquivo para um blob com Escopo de Criptografia.

Parâmetros

-AsJob

Execute o cmdlet em segundo plano.

Propriedades dos parâmetros

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

-Blob

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-BlobType

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

  • Block
  • Página
  • Append

O valor padrão é Block.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Block, Page, Append
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

-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 tentará novamente a solicitação. Se este cmdlet não receber uma resposta bem-sucedida antes do intervalo passar, ele retornará um erro.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ClientTimeoutPerRequestInSeconds

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

-CloudBlob

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

Propriedades dos parâmetros

Tipo:Microsoft.Azure.Storage.Blob.CloudBlob
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ICloudBlob

Conjuntos de parâmetros

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

-CloudBlobContainer

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

Propriedades dos parâmetros

Tipo:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ContainerPipeline
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 principal. 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.

Propriedades dos parâmetros

Tipo:

Nullable<T>[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:False
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

-Container

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

SendManual
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
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: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

-EncryptionScope

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

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

-File

Especifica um caminho de arquivo local para um arquivo a ser carregado como conteúdo de blob.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

-Force

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

Propriedades dos parâmetros

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

-Metadata

Especifica metadados para o blob carregado.

Propriedades dos parâmetros

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

-PremiumPageBlobTier

Camada de Blob de Página

Propriedades dos parâmetros

Tipo:Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
Default value:None
Valores aceites:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
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

-Properties

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

Propriedades dos parâmetros

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

-ServerTimeoutPerRequest

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

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ServerTimeoutPerRequestInSeconds

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

-StandardBlobTier

Bloco Blob Tier, os valores válidos são Hot/Cool/Archive/Cold. Ver detalhe em https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

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

-Tag

Etiquetas Blob

Propriedades dos parâmetros

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

-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 tags de blob não corresponderem à expressão fornecida. Veja os detalhes em https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
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

String

Microsoft.Azure.Storage.Blob.CloudBlobContainer

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Saídas

AzureStorageBlob