Get-AzStorageBlobContent

Módulo:

Az.Storage Module

Descarga un blob de almacenamiento.

Sintaxis

ReceiveManual (valor predeterminado)

Get-AzStorageBlobContent
    [-Blob] <String>
    [-Container] <String>
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipeline

Get-AzStorageBlobContent
    -CloudBlob <CloudBlob>
    [-BlobBaseClient <BlobBaseClient>]
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ContainerPipeline

Get-AzStorageBlobContent
    [-Blob] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UriPipeline

Get-AzStorageBlobContent
    -AbsoluteUri <String>
    [-Destination <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Get-AzStorageBlobContent descarga el blob de almacenamiento especificado. Si el nombre del blob no es válido para el equipo local, este cmdlet lo resuelve automáticamente si es posible.

Ejemplos

Ejemplo 1: Descarga del contenido del blob por nombre

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

Este comando descarga un blob por nombre.

Ejemplo 2: Descarga del contenido del blob mediante la canalización

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

Este comando usa la canalización para buscar y descargar contenido de blob.

Ejemplo 3: Descarga del contenido del blob mediante la canalización y un carácter comodín

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

En este ejemplo se usa el carácter comodín asterisco y la canalización para buscar y descargar contenido de blob.

Ejemplo 4: Obtención de un objeto de blob y guárdelo en una variable y, a continuación, descargue el contenido del blob con el objeto blob.

$blob = Get-AzStorageBlob -Container containername -Blob blobname
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

En este ejemplo, primero se obtiene un objeto de blob y se guarda en una variable y, a continuación, se descarga el contenido del blob con el objeto blob.

Ejemplo 5: Descarga de contenido de blobs con URI de blob

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

En este ejemplo se descargará un contenido de blob con URI, el URI puede ser un URI con el token de Sas. Si el blob está en una cuenta de disco administrado y el servidor requiere un token de portador además del URI de Sas para descargarlo, el cmdlet intentará generar un token de portador con la audiencia devuelta por el servidor y la credencial de usuario de AAD de inicio de sesión, descargue el blob con el URI de Sas y el token de portador.

Parámetros

-AbsoluteUri

URI de blob desde el que se va a descargar.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Uri, BlobUri

Conjuntos de parámetros

UriPipeline

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-AsJob

Ejecute el cmdlet en segundo plano.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Blob

Especifica el nombre del blob que se va a descargar.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ReceiveManual

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

ContainerPipeline

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-BlobBaseClient

BlobBaseClient (objeto)

Propiedades de parámetro

Tipo:	BlobBaseClient
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

BlobPipeline

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-CheckMd5

Especifica si se debe comprobar la suma md5 del archivo descargado.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ReceiveManual

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

BlobPipeline

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

ContainerPipeline

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ClientTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado cliente, en segundos, para una solicitud de servicio. Si se produce un error en la llamada anterior en el intervalo especificado, este cmdlet reintenta la solicitud. Si este cmdlet no recibe una respuesta correcta antes de que transcurre el intervalo, este cmdlet devuelve un error.

Propiedades de parámetro

Tipo:	Nullable<T>[Int32]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	ClientTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-CloudBlob

Especifica un blob en la nube. Para obtener un objeto CloudBlob , use el cmdlet Get-AzStorageBlob.

Propiedades de parámetro

Tipo:	Microsoft.Azure.Storage.Blob.CloudBlob
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	ICloudBlob

Conjuntos de parámetros

BlobPipeline

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-CloudBlobContainer

Especifica un objeto CloudBlobContainer de la biblioteca cliente de Azure Storage. Puede crearlo o usar el cmdlet Get-AzStorageContainer.

Propiedades de parámetro

Tipo:	Microsoft.Azure.Storage.Blob.CloudBlobContainer
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ContainerPipeline

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ConcurrentTaskCount

Especifica el número máximo de llamadas de red simultáneas. Puede usar este parámetro para limitar la simultaneidad para limitar el uso de ancho de banda y CPU local especificando el número máximo de llamadas de red simultáneas. El valor especificado es un recuento absoluto y no se multiplica por el recuento de núcleos. Este parámetro puede ayudar a reducir los problemas de conexión de red en entornos de ancho de banda bajo, como 100 kilobits por segundo. El valor predeterminado es 10.

Propiedades de parámetro

Tipo:	Nullable<T>[Int32]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Container

Especifica el nombre del contenedor que tiene el blob que desea descargar.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ReceiveManual

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Context

Especifica la cuenta de Almacenamiento de Azure desde la que desea descargar el contenido del blob. Puede usar el cmdlet New-AzStorageContext para crear un contexto de almacenamiento.

Propiedades de parámetro

Tipo:	IStorageContext
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ReceiveManual

Posición:	Named
Obligatorio:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

BlobPipeline

Posición:	Named
Obligatorio:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

ContainerPipeline

Posición:	Named
Obligatorio:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:	IAzureContextContainer
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Destination

Especifica la ubicación para almacenar el archivo descargado.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Ruta

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Force

Sobrescribe un archivo existente sin confirmación.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ServerTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado del servicio, en segundos, para una solicitud. Si el intervalo especificado transcurre antes de que el servicio procese la solicitud, el servicio de almacenamiento devuelve un error.

Propiedades de parámetro

Tipo:	Nullable<T>[Int32]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	ServerTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-TagCondition

Instrucción de expresión tag opcional para comprobar la condición de coincidencia. Se producirá un error en la solicitud de blob cuando las etiquetas de blob no coincidan con la expresión especificada. Consulte los detalles de https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.CloudBlobContainer

IStorageContext

Salidas

AzureStorageBlob

Notas

• Si el nombre del blob no es válido para el equipo local, este cmdlet lo aplica, si es posible.

Vínculos relacionados

• Set-AzStorageBlobContent
• Get-AzStorageBlob
• Remove-AzStorageBlob