Get-AzStorageBlob
Wyświetla listę obiektów blob w kontenerze.
Składnia
BlobName (domyślnie)
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>]
SingleBlobSnapshotTime
Get-AzStorageBlob
[-Blob] <String>
[-Container] <String>
-SnapshotTime <DateTimeOffset>
[-IncludeDeleted]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
SingleBlobVersionID
Get-AzStorageBlob
[-Blob] <String>
[-Container] <String>
-VersionId <String>
[-IncludeDeleted]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
BlobPrefix
Get-AzStorageBlob
[-Container] <String>
[-Prefix <String>]
[-IncludeDeleted]
[-IncludeVersion]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Opis
Polecenie cmdlet Get-AzStorageBlob wyświetla obiekty blob w określonym kontenerze na koncie usługi Azure Storage.
Przykłady
Przykład 1. Pobieranie obiektu blob według nazwy obiektu blob
Get-AzStorageBlob -Container "ContainerName" -Blob blob*
To polecenie używa nazwy obiektu blob i symbolu wieloznakowego, aby uzyskać obiekt blob.
Przykład 2. Pobieranie obiektów blob w kontenerze przy użyciu potoku
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
To polecenie używa potoku do pobrania wszystkich obiektów blob (uwzględnij obiekty blob w stanie Usunięty) w kontenerze.
Przykład 3. Pobieranie obiektów blob według prefiksu nazwy
Get-AzStorageBlob -Container "ContainerName" -Prefix "blob"
To polecenie używa prefiksu nazwy do pobierania obiektów blob.
Przykład 4. Wyświetlanie listy obiektów blob w wielu partiach
$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"
W tym przykładzie użyto parametrów MaxCount i ContinuationToken , aby wyświetlić listę obiektów blob usługi Azure Storage w wielu partiach.
Pierwsze cztery polecenia przypisują wartości do zmiennych do użycia w przykładzie.
Piąte polecenie określa instrukcję Do-While , która używa polecenia cmdlet Get-AzStorageBlob w celu pobrania obiektów blob.
Instrukcja zawiera token kontynuacji przechowywany w zmiennej $Token.
$Token zmienia wartość podczas uruchamiania pętli.
Aby uzyskać więcej informacji, wpisz Get-Help About_Do.
Ostatnie polecenie używa polecenia Echo , aby wyświetlić sumę.
Przykład 5. Pobieranie wszystkich obiektów blob w kontenerze obejmuje wersję obiektu 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 *
To polecenie pobiera wszystkie obiekty blob w kontenerze, w tym wersję obiektu blob.
Przykład 6. Pobieranie pojedynczej wersji obiektu 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
To polecenie pobiera jedną wersję obiektów blob z identyfikatorem VersionId.
Przykład 7. Pobieranie pojedynczej migawki obiektu 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
To polecenie pobiera pojedynczą migawkę obiektów blob za pomocą funkcji SnapshotTime.
Przykład 8. Pobieranie tagów obiektów blob zawierających obiekty 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
To polecenie wyświetla listę obiektów blob z kontenera z tagami obiektów blob i pokazuje tagi pierwszego obiektu blob.
Przykład 9. Pobieranie pojedynczego obiektu blob z warunkiem tagu obiektu 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 *
To polecenie pobiera pojedynczy obiekt blob z warunkiem tagu obiektu blob.
Polecenie cmdlet zakończy się powodzeniem tylko wtedy, gdy obiekt blob zawiera tag o nazwie "tag1" i wartości "value1", w przeciwnym razie polecenie cmdlet zakończy się niepowodzeniem z kodem błędu 412.
Przykład 10: Pobieranie właściwości obiektu blob (na przykład: ImmutabilityPolicy) pojedynczego obiektu 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
To przykładowe polecenie pobiera właściwość niezmienności pojedynczego obiektu blob. Szczegółową listę właściwości obiektu blob można uzyskać z właściwości BlobProperties , w tym między innymi: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy itp. Aby wyświetlić listę wielu obiektów blob (wykonaj polecenie cmdlet bez nazwy obiektu blob), użyj właściwości ListBlobProperties.Properties zamiast obiektu BlobProperties w celu uzyskania lepszej wydajności.
Parametry
-Blob
Określa wzorzec nazwy lub nazwy, który może służyć do wyszukiwania symboli wieloznacznych.
Jeśli nie określono nazwy obiektu blob, polecenie cmdlet wyświetla listę wszystkich obiektów blob w określonym kontenerze.
Jeśli dla tego parametru określono wartość, polecenie cmdlet wyświetla listę wszystkich obiektów blob z nazwami odpowiadającymi temu parametrowi. Ten parametr obsługuje symbole wieloznaczne w dowolnym miejscu w ciągu.
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: True DontShow: False
Zestawy parametrów
BlobName
Position: 0 Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-ClientTimeoutPerRequest
Określa interwał limitu czasu po stronie klienta w sekundach dla jednego żądania obsługi.
Jeśli poprzednie wywołanie zakończy się niepowodzeniem w określonym interwale, to polecenie cmdlet ponawia próbę żądania.
Jeśli to polecenie cmdlet nie otrzyma pomyślnej odpowiedzi przed upływem interwału, to polecenie cmdlet zwróci błąd.
Właściwości parametru
Typ: Nullable<T> [ Int32 ]
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: ClientTimeoutPerRequestInSeconds
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-ConcurrentTaskCount
Określa maksymalne współbieżne wywołania sieciowe.
Tego parametru można użyć, aby ograniczyć współbieżność w celu ograniczenia użycia lokalnego procesora CPU i przepustowości, określając maksymalną liczbę współbieżnych wywołań sieciowych.
Określona wartość jest liczbą bezwzględną i nie jest mnożona przez liczbę rdzeni.
Ten parametr może pomóc w zmniejszeniu problemów z połączeniem sieciowym w środowiskach o niskiej przepustowości, takich jak 100 kilobitów na sekundę.
Wartość domyślna to 10.
Właściwości parametru
Typ: Nullable<T> [ Int32 ]
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-Container
Określa nazwę kontenera.
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: N, Name
Zestawy parametrów
(All)
Position: 1 Obowiązkowe: True Wartość z potoku: False Wartość z potoku według nazwy właściwości: True Wartość z pozostałych argumentów: False
-Context
Określa konto usługi Azure Storage, z którego chcesz uzyskać listę obiektów blob.
Aby utworzyć kontekst magazynu, możesz użyć polecenia cmdlet New-AzStorageContext.
Właściwości parametru
Typ: IStorageContext
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: True Wartość z pozostałych argumentów: False
-ContinuationToken
Określa token kontynuacji dla listy obiektów blob.
Użyj tego parametru i parametru MaxCount , aby wyświetlić listę obiektów blob w wielu partiach.
Właściwości parametru
Typ: Microsoft.Azure.Storage.Blob.BlobContinuationToken
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Właściwości parametru
Typ: IAzureContextContainer
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: AzureRmContext, AzureCredential
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-IncludeDeleted
Uwzględnij usunięty obiekt blob, domyślnie pobierz obiekt blob nie będzie zawierać usuniętego obiektu blob.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-IncludeTag
Uwzględnianie tagów obiektów blob domyślnie get blob nie będzie zawierać tagów obiektów blob.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-IncludeVersion
Wersje obiektów blob będą wyświetlane tylko wtedy, gdy ten parametr jest obecny, domyślnie get blob nie będzie zawierać wersji obiektów blob.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
BlobPrefix
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-MaxCount
Określa maksymalną liczbę obiektów zwracanych przez to polecenie cmdlet.
Właściwości parametru
Typ: Nullable<T> [ Int32 ]
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-Prefix
Określa prefiks nazw obiektów blob, które chcesz uzyskać.
Ten parametr nie obsługuje wyszukiwania przy użyciu wyrażeń regularnych ani symboli wieloznacznych.
Oznacza to, że jeśli kontener ma tylko obiekty blob o nazwach "My", "MyBlob1" i "MyBlob2", a następnie określisz wartość "-Prefix My*", polecenie cmdlet nie zwraca żadnych obiektów blob.
Jeśli jednak określisz wartość "-Prefix My", polecenie cmdlet zwróci wartość "My", "MyBlob1" i "MyBlob2".
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
BlobPrefix
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-ServerTimeoutPerRequest
Określa interwał limitu czasu po stronie usługi w sekundach dla żądania.
Jeśli określony interwał upłynie, zanim usługa przetworzy żądanie, usługa magazynu zwróci błąd.
Właściwości parametru
Typ: Nullable<T> [ Int32 ]
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: ServerTimeoutPerRequestInSeconds
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-SnapshotTime
Czas migawki obiektu blob
Właściwości parametru
Zestawy parametrów
SingleBlobSnapshotTime
Position: Named Obowiązkowe: True Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-TagCondition
Opcjonalna instrukcja wyrażenia tagu w celu sprawdzenia warunku dopasowania.
Żądanie obiektu blob zakończy się niepowodzeniem, gdy tagi obiektów blob nie są zgodne z danym wyrażeniem.
Zobacz szczegóły w pliku https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations .
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
BlobName
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
SingleBlobSnapshotTime
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
SingleBlobVersionID
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-VersionId
Identyfikator wersji obiektu blob
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
SingleBlobVersionID
Position: Named Obowiązkowe: True Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters .
Dane wyjściowe
