Udostępnij przez

Get-AzStorageBlobContent

Moduł:
Az.Storage Module

Pobiera obiekt blob magazynu.

Składnia

ReceiveManual (Domyślne) 

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

BlobPipeline 

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

ContainerPipeline 

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

UriPipeline 

Get-AzStorageBlobContent
    -AbsoluteUri <String>
    [-Destination <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 do pobrania, polecenie cmdlet spróbuje wygenerować token elementu nośnego z zwróconymi odbiorcami serwera i poświadczeniami użytkownika logowania 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.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Uri, BlobUri

Zbiory parametrów

UriPipeline
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-AsJob

Uruchom polecenie cmdlet w tle.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Blob

Określa nazwę obiektu blob do pobrania.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ReceiveManual
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ContainerPipeline
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-BlobBaseClient

Obiekt BlobBaseClient

Właściwości parametrów

Typ:BlobBaseClient
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

BlobPipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-CheckMd5

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ReceiveManual
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
BlobPipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
ContainerPipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:ClientTimeoutPerRequestInSeconds

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-CloudBlob

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

Właściwości parametrów

Typ:Microsoft.Azure.Storage.Blob.CloudBlob
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:ICloudBlob

Zbiory parametrów

BlobPipeline
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-CloudBlobContainer

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

Właściwości parametrów

Typ:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ContainerPipeline
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Container

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ReceiveManual
Pozycja:1
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:IStorageContext
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ReceiveManual
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
BlobPipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False
ContainerPipeline
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Destination

Określa lokalizację do przechowywania pobranego pliku.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Ścieżka

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Force

Zastępuje istniejący plik bez potwierdzenia.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

Nullable<T>[Int32]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:ServerTimeoutPerRequestInSeconds

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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 pliku https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WhatIf

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.CloudBlobContainer

IStorageContext

Wyjść

AzureStorageBlob

Notatki

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