Get-AzStorageBlob

Başvuru

Modül:: Az.Storage

Kapsayıcıdaki blobları listeler.

Sözdizimi

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

Örnek 10: Tek bir blobun blob özelliklerini alma (örnek: ImmutabilityPolicy)

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

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

Bu örnek komut tek bir blobun değişmezlik özelliğini alır. BlobProperties özelliğinden aşağıdakiler dahil olmak üzere blob prTooperties'in ayrıntılı bir listesini alabilirsiniz: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy vb.. Birden çok blobu listelemek için (cmdlet'i blob adı olmadan yürütür), daha iyi performans için BlobProperties yerine ListBlobProperties.Properties kullanın.

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.

Tür:	String
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Nullable<T>[Int32]
Diğer adlar:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Container

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

Tür:	String
Diğer adlar:	N, Name
Position:	1
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Context

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

Tür:	IStorageContext
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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.

Tür:	BlobContinuationToken
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DefaultProfile

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

Tür:	IAzureContextContainer
Diğer adlar:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IncludeDeleted

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IncludeTag

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IncludeVersion

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-MaxCount

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

Tür:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Nullable<T>[Int32]
Diğer adlar:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-SnapshotTime

Blob SnapshotTime

Tür:	Nullable<T>[DateTimeOffset]
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-VersionId

Blob VersionId

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

String

IStorageContext

Çıkışlar

AzureStorageBlob

Aracılığıyla paylaş

Get-AzStorageBlob

Sözdizimi

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

Örnek 10: Tek bir blobun blob özelliklerini alma (örnek: ImmutabilityPolicy)

Parametreler

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Girişler

Çıkışlar

Ek kaynaklar

Aracılığıyla paylaş

Get-AzStorageBlob

Sözdizimi

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

Örnek 10: Tek bir blobun blob özelliklerini alma (örnek: ImmutabilityPolicy)

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

Ek kaynaklar