Get-AzStorageBlob
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
Çıkışlar
İlişkili Bağlantılar
Azure PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin