Get-AzStorageBlob

Referencia

Módulo:: Az.Storage

Enumera los blobs de un contenedor.

Sintaxis

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

Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -SnapshotTime <DateTimeOffset>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -VersionId <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

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

Description

El cmdlet Get-AzStorageBlob enumera los blobs del contenedor especificado en una cuenta de Azure Storage.

Ejemplos

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

Get-AzStorageBlob -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

Get-AzStorageContainer -Name container* | Get-AzStorageBlob -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

Get-AzStorageBlob -Container "ContainerName" -Prefix "blob"

Este comando usa un prefijo de nombre para obtener blobs.

Ejemplo 4: Enumeración de blobs en varios lotes

$MaxReturn = 10000
$ContainerName = "abc"
$Total = 0
$Token = $Null
do
 {
     $Blobs = Get-AzStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($null -ne $Token)
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-AzStorageBlob 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.

Ejemplo 5: Obtener todos los blobs de un contenedor incluyen la versión del blob

Get-AzStorageBlob -Container "containername"  -IncludeVersion

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot                                     False      2020-07-06T06:56:06.2432658Z  
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot        2020-07-06T06:56:06.8588431Z False                                    
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot                                     False      2020-07-06T06:56:06.8598431Z *  
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:16Z Hot                                     False      2020-07-03T16:19:16.2883167Z  
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:35Z Hot                                     False      2020-07-03T16:19:35.2381110Z *

Este comando obtiene todos los blobs de un contenedor incluyen la versión del blob.

Ejemplo 6: Obtención de una sola versión de blob

Get-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:16Z Hot                                     False      2020-07-03T16:19:16.2883167Z

Este comando obtiene un solo verbo de blobs con VersionId.

Ejemplo 7: Obtención de una sola instantánea de blob

Get-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot        2020-07-06T06:56:06.8588431Z False

Este comando obtiene una sola instantánea de blobs con SnapshotTime.

Ejemplo 8: Obtener blob incluyen etiquetas de blob

$blobs = Get-AzStorageBlob -Container "containername" -IncludeTag

$blobs

   AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:02Z Hot                                     False      2020-07-23T09:35:02.8527357Z *
testblob2            BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:04Z Hot                                     False      2020-07-23T09:35:04.0856187Z *


$blobs[0].Tags
Name          Value 
----          -----
tag1          value1
tag2          value2

Este comando enumera los blobs de un contenedor con etiquetas de blob y muestra las etiquetas del primer blob.

Ejemplo 9: Obtención de un único blob con condición de etiqueta de blob

Get-AzStorageBlob -Container "containername" -Blob testblob -TagCondition """tag1""='value1'"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:02Z Hot                                     False      2020-07-23T09:35:02.8527357Z *

Este comando obtiene un único blob con condición de etiqueta de blob. El cmdlet solo se realizará correctamente cuando el blob contenga una etiqueta con el nombre "tag1" y el valor "value1", de lo contrario, se producirá un error en el código de error 412.

Ejemplo 10: Obtención de propiedades de blob (ejemplo: ImmutabilityPolicy) de un único blob

$blobProperties = (Get-AzStorageBlob -Container "ContainerName" -Blob "blob" -Context $ctx).BlobProperties
$blobProperties.ImmutabilityPolicy

ExpiresOn                   PolicyMode
---------                   ----------
9/17/2024 2:49:32 AM +00:00   Unlocked

Este comando de ejemplo obtiene la propiedad de inmutabilidad de un único blob. Puede obtener una lista detallada de los blobs prTooperties de la propiedad BlobProperties , incluidos, entre otros: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy, etc. Para enumerar varios blobs (ejecute el cmdlet sin nombre de blob), use ListBlobProperties.Properties en lugar de BlobProperties para mejorar el rendimiento.

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. Este parámetro admite caracteres comodín en cualquier parte de la cadena.

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

-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]
Alias:	ClientTimeoutPerRequestInSeconds
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-AzStorageContext 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

-IncludeTag

Incluir etiquetas de blob; de forma predeterminada, get blob no incluirá etiquetas de blob.

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

-IncludeVersion

Las versiones de blobs solo se mostrarán si este parámetro está presente, de forma predeterminada get blob no incluirá versiones de blobs.

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

-SnapshotTime

SnapshotTime de blobs

Tipo:	Nullable<T>[DateTimeOffset]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 en https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-VersionId

Blob VersionId

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

Entradas

String

IStorageContext

Salidas

AzureStorageBlob

Compartir a través de

Get-AzStorageBlob

Sintaxis

Description

Ejemplos

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

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

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

Ejemplo 4: Enumeración de blobs en varios lotes

Ejemplo 5: Obtener todos los blobs de un contenedor incluyen la versión del blob

Ejemplo 6: Obtención de una sola versión de blob

Ejemplo 7: Obtención de una sola instantánea de blob

Ejemplo 8: Obtener blob incluyen etiquetas de blob

Ejemplo 9: Obtención de un único blob con condición de etiqueta de blob

Ejemplo 10: Obtención de propiedades de blob (ejemplo: ImmutabilityPolicy) de un único blob

Parámetros

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Entradas

Salidas

Recursos adicionales

Compartir a través de

Get-AzStorageBlob

Sintaxis

Description

Ejemplos

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

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

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

Ejemplo 4: Enumeración de blobs en varios lotes

Ejemplo 5: Obtener todos los blobs de un contenedor incluyen la versión del blob

Ejemplo 6: Obtención de una sola versión de blob

Ejemplo 7: Obtención de una sola instantánea de blob

Ejemplo 8: Obtener blob incluyen etiquetas de blob

Ejemplo 9: Obtención de un único blob con condición de etiqueta de blob

Ejemplo 10: Obtención de propiedades de blob (ejemplo: ImmutabilityPolicy) de un único blob

Parámetros

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Entradas

Salidas

Vínculos relacionados

Recursos adicionales