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

Get-AzStorageContainer

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

Выводит список контейнеров хранилища.

Синтаксис

Get-AzStorageContainer
   [[-Name] <String>]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-IncludeDeleted]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageContainer
   -Prefix <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-IncludeDeleted]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1. Получение контейнера служба хранилища Azure по имени

Get-AzStorageContainer -Name container*

В этом примере для возврата списка всех контейнеров с именем, начинающимся с контейнера, используется подстановочный знак.

Пример 2. Получение контейнера служба хранилища Azure по префиксу имени контейнера

Get-AzStorageContainer -Prefix "container"

В этом примере используется параметр префикса для возврата списка всех контейнеров с именем, начинающимся с контейнера.

Пример 3. Список контейнеров служба хранилища Azure, включая удаленные контейнеры

$containers =  Get-AzStorageContainer -IncludeDeleted -Context $ctx 

$containers

   Storage Account Name: storageaccountname

Name                 PublicAccess         LastModified                   IsDeleted  VersionId                                                                                                                                                                                                                                                      
----                 ------------         ------------                   ---------  ---------                                                                                                                                                                   
testcon              Off                  8/28/2020 10:18:13 AM +00:00                                                                                                                                                                                                                                                                   
testcon2                                  9/4/2020 12:52:37 PM +00:00    True       01D67D248986B6DA  

$c[1].BlobContainerProperties

LastModified                   : 9/4/2020 12:52:37 PM +00:00
LeaseStatus                    : Unlocked
LeaseState                     : Expired
LeaseDuration                  : 
PublicAccess                   : 
HasImmutabilityPolicy          : False
HasLegalHold                   : False
DefaultEncryptionScope         : $account-encryption-key
PreventEncryptionScopeOverride : False
DeletedOn                      : 9/8/2020 4:29:59 AM +00:00
RemainingRetentionDays         : 299
ETag                           : "0x8D850D167059285"
Metadata                       : {}

В этом примере перечислены все контейнеры учетной записи хранения, включая удаленные контейнеры. Затем отображаются свойства удаленного контейнера, в том числе: DeletedOn, RemainingRetentionDays. Удаленные контейнеры будут существовать только после включения softdelete container с enable-AzStorageBlobDeleteRetentionPolicy.

Параметры

-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

-Context

Указывает контекст хранилища. Чтобы создать его, можно использовать командлет New-AzStorageContext. Разрешения контейнера не будут получены при использовании контекста хранилища, созданного из маркера SAS, так как разрешения контейнера запросов требуют разрешения ключа учетной записи хранения.

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

-ContinuationToken

Указывает маркер продолжения для списка BLOB-объектов.

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

-DefaultProfile

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

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

-IncludeDeleted

Включить удаленные контейнеры, по умолчанию контейнеры списка не будут включать удаленные контейнеры

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

-MaxCount

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

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

-Name

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

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

-Prefix

Указывает префикс, используемый в имени контейнера или контейнеров, которые требуется получить. Это можно использовать для поиска всех контейнеров, начинающихся с одной строки, например "my" или "test".

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

-ServerTimeoutPerRequest

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

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

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

String

IStorageContext

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

AzureStorageContainer