Compartir a través de

Get-AzureStorageBlob

  • Referencia
Módulo:
Azure.Storage

Enumera los blobs de un contenedor.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Get-AzureStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureStorageBlob enumera blob en el contenedor especificado en una cuenta de Almacenamiento de Azure.

Ejemplos

Ejemplo 1: Obtención de un blob por nombre de blob

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Blob blob*

Este comando usa un nombre de blob y un carácter comodín para obtener un blob.

Ejemplo 2: Obtención de blobs en un contenedor mediante la canalización

PS C:\>Get-AzureStorageContainer -Name container* | Get-AzureStorageBlob -IncludeDeleted

   Container Uri: https://storageaccountname.blob.core.windows.net/container1

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime         IsDeleted 
----                 --------  ------          -----------                    ------------         ---------- ------------         --------- 
test1                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:19Z            2017-11-08 08:19:32Z True      
test1                BlockBlob 403116          application/octet-stream       2017-11-08 09:00:29Z                                 True      
test2                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:00Z                                 False

Este comando usa la canalización para obtener todos los blobs (incluir blobs en estado eliminado) en un contenedor.

Ejemplo 3: Obtención de blobs por prefijo de nombre

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Prefix "blob"

Este comando usa un prefijo de nombre para obtener blobs.

Ejemplo 4: Enumeración de blobs en varios lotes

PS C:\>$MaxReturn = 10000
PS C:\> $ContainerName = "abc"
PS C:\> $Total = 0
PS C:\> $Token = $Null
PS C:\> do
 {
     $Blobs = Get-AzureStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($Token -ne $Null)
PS C:\> Echo "Total $Total blobs in container $ContainerName"

En este ejemplo se usan los parámetros MaxCount y ContinuationToken para enumerar los blobs de Azure Storage en varios lotes. Los cuatro primeros comandos asignan valores a variables que se usarán en el ejemplo. El quinto comando especifica una instrucción Do-While que usa el cmdlet Get-AzureStorageBlob para obtener blobs. La instrucción incluye el token de continuación almacenado en la variable $Token. $Token cambia el valor a medida que se ejecuta el bucle. Para obtener más información, escriba Get-Help About_Do. El comando final usa el comando Echo para mostrar el total.

Parámetros

-Blob

Especifica un nombre o patrón de nombre, que se puede usar para una búsqueda con caracteres comodín. Si no se especifica ningún nombre de blob, el cmdlet enumera todos los blobs del contenedor especificado. Si se especifica un valor para este parámetro, el cmdlet enumera todos los blobs con nombres que coinciden con este parámetro.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Container

Especifica el nombre del contenedor.

Tipo:String
Alias:N, Name
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Context

Especifica la cuenta de almacenamiento de Azure desde la que desea obtener una lista de blobs. Puede usar el cmdlet New-AzureStorageContext para crear un contexto de almacenamiento.

Tipo:IStorageContext
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ContinuationToken

Especifica un token de continuación para la lista de blobs. Use este parámetro y el parámetro MaxCount para enumerar blobs en varios lotes.

Tipo:BlobContinuationToken
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IncludeDeleted

Incluir blob eliminado, de forma predeterminada get blob no incluirá blob eliminado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxCount

Especifica el número máximo de objetos que devuelve este cmdlet.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Prefix

Especifica un prefijo para los nombres de blob que desea obtener. Este parámetro no admite el uso de expresiones regulares ni caracteres comodín para buscar. Esto significa que si el contenedor solo tiene blobs denominados "My", "MyBlob1" y "MyBlob2" y especifica "-Prefix My*", el cmdlet no devuelve ningún blobs. Sin embargo, si especifica "-Prefix My", el cmdlet devuelve "My", "MyBlob1" y "MyBlob2".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

IStorageContext

Salidas

AzureStorageBlob