Udostępnij za pośrednictwem

Get-AzStorageBlobContent

  • Odwołanie
Moduł:
Az.Storage

Pobiera obiekt blob magazynu.

Składnia

Get-AzStorageBlobContent
   [-Blob] <String>
   [-Container] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Context <IStorageContext>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   [-Destination <String>]
   [-CheckMd5]
   [-Context <IStorageContext>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Context <IStorageContext>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   [-Destination <String>]
   -AbsoluteUri <String>
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzStorageBlobContent pobiera określony obiekt blob magazynu. Jeśli nazwa obiektu blob jest nieprawidłowa dla komputera lokalnego, to polecenie cmdlet automatycznie rozpozna je, jeśli jest to możliwe.

Przykłady

Przykład 1. Pobieranie zawartości obiektu blob według nazwy

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

To polecenie pobiera obiekt blob według nazwy.

Przykład 2. Pobieranie zawartości obiektu blob przy użyciu potoku

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

To polecenie używa potoku do znajdowania i pobierania zawartości obiektu blob.

Przykład 3. Pobieranie zawartości obiektu blob przy użyciu potoku i symbolu wieloznacznych

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

W tym przykładzie użyto symbolu wieloznakowego gwiazdki i potoku, aby znaleźć i pobrać zawartość obiektu blob.

Przykład 4. Pobieranie obiektu blob i zapisywanie go w zmiennej, a następnie pobieranie zawartości obiektu blob za pomocą obiektu blob

$blob = Get-AzStorageBlob -Container containername -Blob blobname 
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

W tym przykładzie najpierw pobierz obiekt blob i zapisz go w zmiennej, a następnie pobierz zawartość obiektu blob za pomocą obiektu blob.

Przykład 5. Pobieranie zawartości obiektu blob przy użyciu identyfikatora URI obiektu blob

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

W tym przykładzie zostanie pobrana zawartość obiektu blob z identyfikatorem URI. Identyfikator URI może być identyfikatorem URI z tokenem Sas. Jeśli obiekt blob znajduje się na koncie dysku zarządzanego, a serwer wymaga tokenu elementu nośnego oprócz identyfikatora URI sygnatury dostępu współdzielonego, polecenie cmdlet spróbuje wygenerować token elementu nośnego z zwróconymi odbiorcami serwera i identyfikatorem logowania użytkownika usługi AAD, a następnie pobrać obiekt blob z identyfikatorem URI sygnatury dostępu współdzielonego i tokenem elementu nośnego.

Parametry

-AbsoluteUri

Identyfikator URI obiektu blob do pobrania.

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

-AsJob

Uruchom polecenie cmdlet w tle.

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

-Blob

Określa nazwę obiektu blob do pobrania.

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

-BlobBaseClient

Obiekt BlobBaseClient

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

-CheckMd5

Określa, czy sprawdzić sumę Md5 dla pobranego pliku.

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

-CloudBlob

Określa obiekt blob w chmurze. Aby uzyskać obiekt CloudBlob, użyj polecenia cmdlet Get-AzStorageBlob.

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

-CloudBlobContainer

Określa obiekt CloudBlobContainer z biblioteki klienta usługi Azure Storage. Można go utworzyć lub użyć polecenia cmdlet Get-AzStorageContainer.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Container

Określa nazwę kontenera, który ma obiekt blob, który chcesz pobrać.

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

-Context

Określa konto usługi Azure Storage, z którego chcesz pobrać zawartość obiektu 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

-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

-Destination

Określa lokalizację do przechowywania pobranego pliku.

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

-Force

Zastępuje istniejący plik bez potwierdzenia.

Typ:SwitchParameter
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

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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

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

Dane wejściowe

CloudBlob

CloudBlobContainer

IStorageContext

Dane wyjściowe

AzureStorageBlob

Uwagi

  • Jeśli nazwa obiektu blob jest nieprawidłowa dla komputera lokalnego, to polecenie cmdlet autoresolves, jeśli jest to możliwe.