Get-AzStorageBlobContent
Baixa um blob de armazenamento.
Syntax
Get-AzStorageBlobContent
[-Blob] <String>
[-Container] <String>
[-Destination <String>]
[-CheckMd5]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Get-AzStorageBlobContent
-CloudBlob <CloudBlob>
[-BlobBaseClient <BlobBaseClient>]
[-Destination <String>]
[-CheckMd5]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Get-AzStorageBlobContent
-CloudBlobContainer <CloudBlobContainer>
[-Blob] <String>
[-Destination <String>]
[-CheckMd5]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Get-AzStorageBlobContent
[-Destination <String>]
-AbsoluteUri <String>
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Get-AzStorageBlobContent 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
Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"Este comando baixa um blob por nome.
Exemplo 2: Baixar conteúdo de blob usando o pipeline
Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContentEsse comando usa o pipeline para localizar e baixar conteúdo de blob.
Exemplo 3: Baixar conteúdo de blob usando o pipeline e um caractere curinga
Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"Este exemplo usa o caractere curinga asterisco e o pipeline para localizar e baixar conteúdo de blob.
Exemplo 4: Obter um objeto de blob e salvá-lo em uma variável e, em seguida, baixar o conteúdo de blob com o objeto de blob
$blob = Get-AzStorageBlob -Container containername -Blob blobname
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"Este exemplo primeiro obtém um objeto de blob e o salva em uma variável e, em seguida, baixa o conteúdo de blob com o objeto blob.
Exemplo 5: Baixar um conteúdo de blob com Uri de blob
Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -ForceEste exemplo baixará um conteúdo de blob com Uri, o Uri pode ser um Uri com token Sas. Se o blob estiver em uma conta de disco gerenciado e o servidor exigir um token de portador além do Sas Uri para download, o cmdlet tentará gerar um token de portador com a audiência retornada do servidor e o usuário do AAD de login credentail e, em seguida, baixar o blob com o Sas Uri e o token de portador.
Parâmetros
-AbsoluteUri
Blob uri para download de.
| Type: | String |
| Aliases: | Uri, BlobUri |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AsJob
Execute o cmdlet em segundo plano.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Blob
Especifica o nome do blob a ser baixado.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobBaseClient
Objeto BlobBaseClient
| Type: | BlobBaseClient |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CheckMd5
Especifica se a soma Md5 deve ser verificada para o arquivo baixado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 esse cmdlet não receber uma resposta bem-sucedida antes que o intervalo transcorra, ele retornará um erro.
| Type: | Nullable<T>[Int32] |
| Aliases: | ClientTimeoutPerRequestInSeconds |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CloudBlob
Especifica um blob de nuvem. Para obter um objeto CloudBlob , use o cmdlet Get-AzStorageBlob.
| Type: | CloudBlob |
| Aliases: | ICloudBlob |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CloudBlobContainer
Especifica um objeto CloudBlobContainer da biblioteca de cliente de armazenamento do Azure. Você pode criá-lo ou usar o cmdlet Get-AzStorageContainer.
| Type: | CloudBlobContainer |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Container
Especifica o nome do contêiner que tem o blob que você deseja baixar.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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-AzStorageContext para criar um contexto de armazenamento.
| Type: | IStorageContext |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Destination
Especifica o local para armazenar o arquivo baixado.
| Type: | String |
| Aliases: | Path |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Substitui um arquivo existente sem confirmação.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServerTimeoutPerRequest
Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado transcorrer antes de o serviço processar a solicitação, o serviço de armazenamento retornará um erro.
| Type: | Nullable<T>[Int32] |
| Aliases: | ServerTimeoutPerRequestInSeconds |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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. Confira os detalhes em https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Saídas
Observações
- Se o nome do blob for inválido para o computador local, esse cmdlet o resolverá automaticamente, se possível.
Links Relacionados
Azure PowerShell
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de