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 |