Get-AzStorageBlob

Odwołanie

Moduł:: Az.Storage

Zwraca listę obiektów blob w kontenerze.

Składnia

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>]

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 pojedyncze wierzchołki 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ę prTooperties obiektów 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.

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	True

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

Typ:	Nullable<T>[Int32]
Aliasy:	ClientTimeoutPerRequestInSeconds
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	Nullable<T>[Int32]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Container

Określa nazwę kontenera.

Typ:	String
Aliasy:	N, Name
Position:	1
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	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.

Typ:	IStorageContext
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	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.

Typ:	BlobContinuationToken
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-IncludeDeleted

Uwzględnij usunięty obiekt blob, domyślnie pobierz obiekt blob nie będzie zawierać usuniętego obiektu blob.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-IncludeTag

Uwzględnianie tagów obiektów blob domyślnie get blob nie będzie zawierać tagów obiektów blob.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-MaxCount

Określa maksymalną liczbę obiektów zwracanych przez to polecenie cmdlet.

Typ:	Nullable<T>[Int32]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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".

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	Nullable<T>[Int32]
Aliasy:	ServerTimeoutPerRequestInSeconds
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SnapshotTime

Czas migawki obiektu blob

Typ:	Nullable<T>[DateTimeOffset]
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 na stronie https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-VersionId

Identyfikator wersji obiektu blob

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureStorageBlob

Udostępnij za pośrednictwem

Get-AzStorageBlob

Składnia

Opis

Przykłady

Przykład 1. Pobieranie obiektu blob według nazwy obiektu blob

Przykład 2. Pobieranie obiektów blob w kontenerze przy użyciu potoku

Przykład 3. Pobieranie obiektów blob według prefiksu nazwy

Przykład 4. Wyświetlanie listy obiektów blob w wielu partiach

Przykład 5. Pobieranie wszystkich obiektów blob w kontenerze obejmuje wersję obiektu blob

Przykład 6. Pobieranie pojedynczej wersji obiektu blob

Przykład 7. Pobieranie pojedynczej migawki obiektu blob

Przykład 8. Pobieranie tagów obiektów blob zawierających obiekty blob

Przykład 9. Pobieranie pojedynczego obiektu blob z warunkiem tagu obiektu blob

Przykład 10: Pobieranie właściwości obiektu blob (na przykład: ImmutabilityPolicy) pojedynczego obiektu blob

Parametry

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Dane wejściowe

Dane wyjściowe

Dodatkowe zasoby

Udostępnij za pośrednictwem

Get-AzStorageBlob

Składnia

Opis

Przykłady

Przykład 1. Pobieranie obiektu blob według nazwy obiektu blob

Przykład 2. Pobieranie obiektów blob w kontenerze przy użyciu potoku

Przykład 3. Pobieranie obiektów blob według prefiksu nazwy

Przykład 4. Wyświetlanie listy obiektów blob w wielu partiach

Przykład 5. Pobieranie wszystkich obiektów blob w kontenerze obejmuje wersję obiektu blob

Przykład 6. Pobieranie pojedynczej wersji obiektu blob

Przykład 7. Pobieranie pojedynczej migawki obiektu blob

Przykład 8. Pobieranie tagów obiektów blob zawierających obiekty blob

Przykład 9. Pobieranie pojedynczego obiektu blob z warunkiem tagu obiektu blob

Przykład 10: Pobieranie właściwości obiektu blob (na przykład: ImmutabilityPolicy) pojedynczego obiektu blob

Parametry

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Dane wejściowe

Dane wyjściowe

Linki powiązane

Dodatkowe zasoby