Get-AzStorageBlob

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

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

Синтаксис

Get-AzStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -SnapshotTime <DateTimeOffset>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -VersionId <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeVersion]
   [-IncludeTag]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Описание

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

Примеры

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

Get-AzStorageBlob -Container "ContainerName" -Blob blob*

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

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

Get-AzStorageContainer -Name container* | Get-AzStorageBlob -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. Получение больших двоичных объектов по префиксу имени

Get-AzStorageBlob -Container "ContainerName" -Prefix "blob"

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

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

$MaxReturn = 10000
$ContainerName = "abc"
$Total = 0
$Token = $Null
do
 {
     $Blobs = Get-AzStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($null -ne $Token)
Echo "Total $Total blobs in container $ContainerName"

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

Пример 5. Получение всех БОЛЬШИХ двоичных объектов в контейнере включает версию BLOB-объектов

Get-AzStorageBlob -Container "containername"  -IncludeVersion

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot                                     False      2020-07-06T06:56:06.2432658Z  
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot        2020-07-06T06:56:06.8588431Z False                                    
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot                                     False      2020-07-06T06:56:06.8598431Z *  
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:16Z Hot                                     False      2020-07-03T16:19:16.2883167Z  
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:35Z Hot                                     False      2020-07-03T16:19:35.2381110Z *

Эта команда получает все большие двоичные объекты в контейнере, включая версию BLOB-объектов.

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

Get-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:16Z Hot                                     False      2020-07-03T16:19:16.2883167Z

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

Пример 7. Получение одного моментального снимка БОЛЬШОго двоичного объекта

Get-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot        2020-07-06T06:56:06.8588431Z False

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

Пример 8. Получение большого двоичного объекта включает теги BLOB-объектов

$blobs = Get-AzStorageBlob -Container "containername" -IncludeTag

$blobs

   AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:02Z Hot                                     False      2020-07-23T09:35:02.8527357Z *
testblob2            BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:04Z Hot                                     False      2020-07-23T09:35:04.0856187Z *


$blobs[0].Tags
Name          Value 
----          -----
tag1          value1
tag2          value2

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

Пример 9. Получение одного большого двоичного объекта с условием тега BLOB-объектов

Get-AzStorageBlob -Container "containername" -Blob testblob -TagCondition """tag1""='value1'"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:02Z Hot                                     False      2020-07-23T09:35:02.8527357Z *

Эта команда получает один большой двоичный объект с условием тега BLOB-объектов. Командлет будет успешно выполнен, только если большой двоичный объект содержит тег с именем "tag1" и значением "value1", в противном случае командлет завершится ошибкой с кодом ошибки 412.

Параметры

-Blob

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

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

-ClientTimeoutPerRequest

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

Тип:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
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-AzStorageContext.

Тип: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

-IncludeTag

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

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

-IncludeVersion

Версии 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]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SnapshotTime

Моментальный снимок BLOB-объектов

Тип:Nullable<T>[DateTimeOffset]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера: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

-VersionId

Идентификатор версии BLOB-объектов

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

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

String

IStorageContext

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

AzureStorageBlob