Udostępnij za pośrednictwem


Get-AzureStorageBlob

Zwraca listę obiektów blob w kontenerze.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Get-AzureStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzureStorageBlob wyświetla obiekt blob w określonym kontenerze na koncie usługi Azure Storage.

Przykłady

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

PS C:\>Get-AzureStorageBlob -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

PS C:\>Get-AzureStorageContainer -Name container* | Get-AzureStorageBlob -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

PS C:\>Get-AzureStorageBlob -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

PS C:\>$MaxReturn = 10000
PS C:\> $ContainerName = "abc"
PS C:\> $Total = 0
PS C:\> $Token = $Null
PS C:\> do
 {
     $Blobs = Get-AzureStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($Token -ne $Null)
PS C:\> 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-AzureStorageBlob 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ę.

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.

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

Typ:Nullable<T>[Int32]
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-AzureStorageContext.

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

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

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureStorageBlob