Get-AzStorageBlobContent

  • Ссылка
Модуль:
Az.Storage

Загружает большой двоичный объект хранилища.

Синтаксис

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

Описание

Командлет Get-AzStorageBlobContent скачивает указанный большой двоичный объект хранилища. Если имя большого двоичного объекта недопустимо для локального компьютера, этот командлет автоматически разрешает его, если это возможно.

Примеры

Пример 1. Скачивание содержимого BLOB-объектов по имени

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

Эта команда загружает большой двоичный объект по имени.

Пример 2. Скачивание содержимого BLOB-объектов с помощью конвейера

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

Эта команда использует конвейер для поиска и скачивания содержимого BLOB-объектов.

Пример 3. Скачивание содержимого BLOB-объектов с помощью конвейера и подстановочного знака

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

В этом примере используется подстановочный знак звездочки и конвейер для поиска и скачивания содержимого BLOB-объектов.

Пример 4. Получение объекта BLOB-объекта и его сохранение в переменной, а затем скачивание содержимого BLOB-объектов с помощью объекта BLOB-объектов

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

В этом примере сначала получите объект BLOB-объекта и сохраните его в переменной, а затем скачайте содержимое BLOB-объектов с помощью объекта BLOB-объекта.

Пример 5. Скачивание содержимого BLOB-объектов с помощью URI BLOB-объектов

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

В этом примере будет загружено содержимое большого двоичного объекта с помощью URI, URI может быть URI с маркером Sas. Если большой двоичный объект находится в учетной записи управляемого диска, а для сервера требуется маркер носителя, кроме URI Sas, командлет попытается создать маркер носителя с возвращенной аудиторией сервера и имя входа пользователя AAD, а затем скачать большой двоичный объект с маркером sas URI и носителя.

Параметры

-AbsoluteUri

Универсальный код ресурса (URI) BLOB-объектов для скачивания.

Тип:String
Aliases:Uri, BlobUri
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AsJob

Запустите командлет в фоновом режиме.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Blob

Указывает имя скачиваемого большого двоичного объекта.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-BlobBaseClient

Объект BlobBaseClient

Тип:BlobBaseClient
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-CheckMd5

Указывает, следует ли проверить сумму Md5 для скачаемого файла.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ClientTimeoutPerRequest

Указывает интервал времени ожидания на стороне клиента (в секундах) для одного запроса на обслуживание. Если предыдущий вызов завершается сбоем в указанном интервале, этот командлет повторяет запрос. Если этот командлет не получает успешный ответ до истечения интервала, этот командлет возвращает ошибку.

Тип:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CloudBlob

Указывает облачный большой двоичный объект. Чтобы получить объект CloudBlob , используйте командлет Get-AzStorageBlob.

Тип:CloudBlob
Aliases:ICloudBlob
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-CloudBlobContainer

Указывает объект CloudBlobContainer из клиентской библиотеки хранилища Azure. Его можно создать или использовать командлет Get-AzStorageContainer.

Тип:CloudBlobContainer
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ConcurrentTaskCount

Указывает максимальное число одновременных сетевых вызовов. Этот параметр можно использовать для ограничения параллелизма для регулирования использования локального ЦП и пропускной способности, указав максимальное количество одновременных сетевых вызовов. Указанное значение является абсолютным числом и не умножается на число ядер. Этот параметр может помочь уменьшить проблемы с сетевым подключением в средах с низкой пропускной способностью, например 100 килобит в секунду. Значение по умолчанию — 10.

Тип:Nullable<T>[Int32]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Container

Указывает имя контейнера с большим двоичным объектом, который требуется скачать.

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Context

Указывает учетную запись хранения Azure, из которой требуется скачать содержимое BLOB-объектов. Для создания контекста хранения можно использовать командлет New-AzStorageContext.

Тип:IStorageContext
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Destination

Указывает расположение для хранения скачаемого файла.

Тип:String
Aliases:Path
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Перезаписывает существующий файл без подтверждения.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServerTimeoutPerRequest

Указывает интервал времени ожидания на стороне службы (в секундах) для запроса. Если указанный интервал истекает перед обработкой запроса службой, служба хранилища возвращает ошибку.

Тип:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TagCondition

Необязательный оператор выражения тега для проверки условия соответствия. Запрос большого двоичного объекта завершится ошибкой, если теги BLOB-объектов не соответствуют заданному выражению. Дополнительные сведения приведены в https://video2.skills-academy.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

CloudBlob

CloudBlobContainer

IStorageContext

Выходные данные

AzureStorageBlob

Примечания

  • Если имя большого двоичного объекта недопустимо для локального компьютера, этот командлет автоматически возвращает его, если это возможно.