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.

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.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Container

Określa nazwę kontenera.

Type:	String
Aliases:	N, Name
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-DefaultProfile

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

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

-IncludeDeleted

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

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

-IncludeTag

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-MaxCount

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

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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".

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-SnapshotTime

Czas migawki obiektu blob

Type:	Nullable<T>[DateTimeOffset]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-VersionId

Identyfikator wersji obiektu blob

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

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureStorageBlob

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

Parametry

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Dane wejściowe

Dane wyjściowe

Opinia

Dodatkowe zasoby

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

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

Opinia

Dodatkowe zasoby