Compartilhar via

Get-AzureStorageBlobContent

  • Referência
Módulo:
Azure.Storage

Baixa um blob de armazenamento.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Get-AzureStorageBlobContent
   [-Blob] <String>
   [-Container] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageBlobContent
   -CloudBlob <CloudBlob>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageBlobContent
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Get-AzureStorageBlobContent baixa o blob de armazenamento especificado. Se o nome do blob não for válido para o computador local, esse cmdlet o resolverá automaticamente, se possível.

Exemplos

Exemplo 1: Baixar conteúdo de blob por nome

PS C:\>Get-AzureStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

Esse comando baixa um blob por nome.

Exemplo 2: Baixar conteúdo de blob usando o pipeline

PS C:\>Get-AzureStorageBlob -Container containername -Blob blobname | Get-AzureStorageBlobContent

Esse comando usa o pipeline para localizar e baixar o conteúdo do blob.

Exemplo 3: Baixar conteúdo de blob usando o pipeline e um caractere curinga

PS C:\>Get-AzureStorageContainer container* | Get-AzureStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

Este exemplo usa o caractere curinga asterisco e o pipeline para localizar e baixar o conteúdo do blob.

Parâmetros

-Blob

Especifica o nome do blob a ser baixado.

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

-CheckMd5

Especifica se a soma Md5 do arquivo baixado deve ser verificada.

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

-CloudBlob

Especifica um blob de nuvem. Para obter um objeto CloudBlob , use o cmdlet Get-AzureStorageBlob.

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 de armazenamento do Azure. Você pode criá-lo ou usar o cmdlet Get-AzureStorageContainer.

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. 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 do contêiner que tem o blob que você deseja baixar.

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

-Context

Especifica a conta de armazenamento do Azure da qual você deseja baixar o conteúdo do blob. Você pode usar o cmdlet New-AzureStorageContext para criar um contexto de armazenamento.

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

-Destination

Especifica o local para armazenar o arquivo baixado.

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

-Force

Substitui um arquivo existente sem confirmação.

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

CloudBlob

CloudBlobContainer

IStorageContext

Saídas

AzureStorageBlob

Observações

  • Se o nome do blob for inválido para o computador local, esse cmdlet o resolverá automaticamente, se possível.