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.

Syntax

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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Especifica el nombre del contenedor.

Type:String
Aliases:N, Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:BlobContinuationToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxCount

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

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

IStorageContext

Salidas

AzureStorageBlob