Get-AzStorageBlob

Başvuru

Modül:: Az.Storage

Kapsayıcıdaki blobları listeler.

Syntax

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

Get-Az Depolama Blob cmdlet'i, bir Azure depolama hesabında belirtilen kapsayıcıdaki blobları listeler.

Örnekler

Örnek 1: Blob adına göre blob alma

Get-AzStorageBlob -Container "ContainerName" -Blob blob*

Bu komut blob almak için bir blob adı ve joker karakter kullanır.

Örnek 2: İşlem hattını kullanarak kapsayıcıdaki blobları alma

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

Bu komut, kapsayıcıdaki tüm blobları (Silinmiş durumdaki blobları dahil) almak için işlem hattını kullanır.

Örnek 3: Blobları ada göre alma ön eki

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

Bu komut blobları almak için bir ad ön eki kullanır.

Örnek 4: Blobları birden çok toplu iş halinde listeleme

$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"

Bu örnekte, Azure Depolama bloblarını birden çok toplu işte listelemek için MaxCount ve ContinuationToken parametreleri kullanılır. İlk dört komut, örnekte kullanılacak değişkenlere değerler atar. Beşinci komut, blobları almak için Get-Az Depolama Blob cmdlet'ini kullanan bir Do-While deyimi belirtir. deyimi, $Token değişkeninde depolanan devamlılık belirtecini içerir. $Token, döngü çalıştırılırken değeri değiştirir. Daha fazla bilgi için yazın Get-Help About_Do. Son komut, toplamı görüntülemek için Echo komutunu kullanır.

Örnek 5: Kapsayıcıdaki tüm blobları alma blob sürümünü içerir

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 *

Bu komut, kapsayıcıdaki blob sürümünü içeren tüm blobları alır.

Örnek 6: Tek bir blob sürümü alma

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

Bu komut VersionId ile tek bir blob verion alır.

Örnek 7: Tek bir blob anlık görüntüsü alma

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

Bu komut SnapshotTime ile tek bir blob anlık görüntüsü alır.

Örnek 8: Blob ekleme blob etiketlerini alma

$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

Bu komut, blob etiketleri içeren bir kapsayıcıdaki blobları listeler ve ilk blobun etiketlerini gösterir.

Örnek 9: Blob etiketi koşuluyla tek bir blob alma

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 *

Bu komut, blob etiketi koşuluna sahip tek bir blob alır. Cmdlet yalnızca blob "tag1" ve "value1" değerine sahip bir etiket içerdiğinde başarılı olur, aksi takdirde cmdlet 412 hata koduyla başarısız olur.

Parametreler

-Blob

Joker karakter araması için kullanılabilecek bir ad veya ad deseni belirtir. Hiçbir blob adı belirtilmezse, cmdlet belirtilen kapsayıcıdaki tüm blobları listeler. Bu parametre için bir değer belirtilirse, cmdlet'i bu parametreyle eşleşen adlara sahip tüm blobları listeler. Bu parametre, dizenin herhangi bir yerinde joker karakterleri destekler.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	True

-ClientTimeoutPerRequest

Bir hizmet isteği için istemci tarafı zaman aşımı aralığını saniye cinsinden belirtir. Önceki çağrı belirtilen aralıkta başarısız olursa, bu cmdlet isteği yeniden dener. Bu cmdlet, aralık tamamlanmadan başarılı bir yanıt almazsa, bu cmdlet bir hata döndürür.

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

-ConcurrentTaskCount

En fazla eşzamanlı ağ çağrısını belirtir. Eşzamanlı ağ çağrılarının maksimum sayısını belirterek yerel CPU ve bant genişliği kullanımını kısıtlamak için eşzamanlılığı sınırlamak için bu parametreyi kullanabilirsiniz. Belirtilen değer mutlak bir sayıdır ve çekirdek sayısıyla çarpılmaz. Bu parametre, saniyede 100 kilobit gibi düşük bant genişliğine bağlı ortamlardaki ağ bağlantısı sorunlarını azaltmaya yardımcı olabilir. Varsayılan değer 10'dur.

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

-Container

Kapsayıcının adını belirtir.

Type:	String
Aliases:	N, Name
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Context

Blobların listesini almak istediğiniz Azure depolama hesabını belirtir. Depolama bağlamı oluşturmak için New-Az Depolama Context cmdlet'ini kullanabilirsiniz.

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

-ContinuationToken

Blob listesi için bir devamlılık belirteci belirtir. Blobları birden çok toplu işte listelemek için bu parametreyi ve MaxCount parametresini kullanın.

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

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

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

-IncludeDeleted

Silinen Blobu Dahil Et, varsayılan olarak get blob silinmiş blobu içermez.

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

-IncludeTag

Blob etiketlerini ekle, varsayılan olarak get blob blob etiketlerini içermez.

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

-IncludeVersion

Blob sürümleri yalnızca bu parametre mevcutsa listelenir, varsayılan olarak get blob blobu blob sürümlerini içermez.

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

-MaxCount

Bu cmdlet'in döndürdüğü en fazla nesne sayısını belirtir.

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

-Prefix

Almak istediğiniz blob adları için bir ön ek belirtir. Bu parametre, aramak için normal ifadelerin veya joker karakterlerin kullanılmasını desteklemez. Bu, kapsayıcıda yalnızca "My", "MyBlob1" ve "MyBlob2" adlı bloblar varsa ve "-Prefix My*" belirtirseniz cmdlet'in blob döndürmediği anlamına gelir. Ancak , "-Prefix My" belirtirseniz, cmdlet "My", "MyBlob1" ve "MyBlob2" döndürür.

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

-ServerTimeoutPerRequest

İstek için hizmet tarafı zaman aşımı aralığını saniye cinsinden belirtir. Belirtilen aralık hizmetin isteği işlemeden önce geçmesi durumunda depolama hizmeti bir hata döndürür.

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

-SnapshotTime

Blob SnapshotTime

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

-TagCondition

Eşleştirme koşulunu denetlemek için isteğe bağlı Etiket ifadesi deyimi. Blob etiketleri verilen ifadeyle eşleşmediğinde blob isteği başarısız olur. https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations sayfasındaki ayrıntılara bakın.

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

-VersionId

Blob VersionId

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

Girişler

String

IStorageContext

Çıkışlar

AzureStorageBlob

Get-AzStorageBlob

Syntax

Description

Örnekler

Örnek 1: Blob adına göre blob alma

Örnek 2: İşlem hattını kullanarak kapsayıcıdaki blobları alma

Örnek 3: Blobları ada göre alma ön eki

Örnek 4: Blobları birden çok toplu iş halinde listeleme

Örnek 5: Kapsayıcıdaki tüm blobları alma blob sürümünü içerir

Örnek 6: Tek bir blob sürümü alma

Örnek 7: Tek bir blob anlık görüntüsü alma

Örnek 8: Blob ekleme blob etiketlerini alma

Örnek 9: Blob etiketi koşuluyla tek bir blob alma

Parametreler

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Girişler

Çıkışlar

Geri Bildirim

Ek kaynaklar

Get-AzStorageBlob

Syntax

Description

Örnekler

Örnek 1: Blob adına göre blob alma

Örnek 2: İşlem hattını kullanarak kapsayıcıdaki blobları alma

Örnek 3: Blobları ada göre alma ön eki

Örnek 4: Blobları birden çok toplu iş halinde listeleme

Örnek 5: Kapsayıcıdaki tüm blobları alma blob sürümünü içerir

Örnek 6: Tek bir blob sürümü alma

Örnek 7: Tek bir blob anlık görüntüsü alma

Örnek 8: Blob ekleme blob etiketlerini alma

Örnek 9: Blob etiketi koşuluyla tek bir blob alma

Parametreler

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Girişler

Çıkışlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar