Поделиться через

Get-AzureStorageBlob

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

Возвращает список больших двоичных объектов в контейнере.

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

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

Описание

Командлет Get-Azure служба хранилища Blob содержит большой двоичный объект в указанном контейнере в учетной записи хранения Azure.

Примеры

Пример 1. Получение большого двоичного объекта по имени большого двоичного объекта

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Blob blob*

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

Пример 2. Получение больших двоичных объектов в контейнере с помощью конвейера

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

Эта команда использует конвейер для получения всех больших двоичных объектов (включая большие двоичные объекты в состояние "Удаленный") в контейнере.

Пример 3. Получение больших двоичных объектов по префиксу имени

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Prefix "blob"

Эта команда использует префикс имени для получения больших двоичных объектов.

Пример 4. Перечисление больших двоичных объектов в нескольких пакетах

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"

В этом примере параметры MaxCount и ContinuationToken используются для перечисления служба хранилища Azure больших двоичных объектов в нескольких пакетах. Первые четыре команды назначают значения переменным для использования в примере. Пятая команда указывает инструкцию Do-While, которая использует командлет Get-Azure служба хранилища Blob для получения больших двоичных объектов. Инструкция включает маркер продолжения, хранящийся в переменной $Token. $Token изменяет значение при выполнении цикла. Для получения дополнительных сведений введите Get-Help About_Do. Последняя команда использует команду Echo для отображения итогового значения.

Параметры

-Blob

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

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

-ClientTimeoutPerRequest

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

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

-ConcurrentTaskCount

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

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

-Container

Указывает имя контейнера.

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

-Context

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

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

-ContinuationToken

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

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

-DefaultProfile

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

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

-IncludeDeleted

Включить удаленный BLOB-объект, по умолчанию get BLOB-объект не будет включать удаленный BLOB-объект.

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

-MaxCount

Указывает максимальное количество объектов, возвращаемых этим командлетом.

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

-Prefix

Задает префикс для имен BLOB-объектов, которые требуется получить. Этот параметр не поддерживает использование регулярных выражений или диких символов карта для поиска. Это означает, что если в контейнере есть только большие двоичные объекты с именем "My", "MyBlob1" и "MyBlob2", и вы указываете "-Префикс My*", командлет возвращает не большие двоичные объекты. Однако если указать "-Префикс My", командлет возвращает "My", "My", "MyBlob1" и "MyBlob2".

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

-ServerTimeoutPerRequest

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

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

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

String

IStorageContext

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

AzureStorageBlob