Aracılığıyla paylaş

Get-AzStorageContainer

  • Başvuru
Modül:
Az.Storage

Depolama kapsayıcılarını listeler.

Sözdizimi

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

Description

Get-AzStorageContainer cmdlet'i, Azure'daki depolama hesabıyla ilişkili depolama kapsayıcılarını listeler.

Örnekler

Örnek 1: Ada göre Azure Depolama kapsayıcısı alma

Get-AzStorageContainer -Name container*

Bu örnekte, kapsayıcıyla başlayan bir ada sahip tüm kapsayıcıların listesini döndürmek için joker karakter kullanılır.

Örnek 2: Kapsayıcı adı ön ekini kullanarak Azure Depolama kapsayıcısı alma

Get-AzStorageContainer -Prefix "container"

Bu örnekte, kapsayıcıyla başlayan bir ada sahip tüm kapsayıcıların listesini döndürmek için Prefix parametresi kullanılır.

Örnek 3: Azure Depolama kapsayıcısı listeleme, silinen kapsayıcıları ekleme

$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                       : {}

Bu örnekte, silinen kapsayıcılar dahil olmak üzere bir depolama hesabının tüm kapsayıcıları listelenir. Ardından silinen kapsayıcı özelliklerini gösterin: DeletedOn, RemainingRetentionDays. Silinen kapsayıcılar yalnızca Enable-AzStorageBlobDeleteRetentionPolicy ile kapsayıcı geçici çözümü etkinleştirildikten sonra mevcut olur.

Parametreler

-ClientTimeoutPerRequest

Bir hizmet isteği için istemci tarafı zaman aşımı aralığını saniye cinsinden belirtir. Önceki çağrı belirtilen aralıkta başarısız olursa, bu cmdlet isteği yeniden dener. Bu cmdlet, aralık tamamlanmadan başarılı bir yanıt almazsa, bu cmdlet bir hata döndürür.

Tür:Nullable<T>[Int32]
Diğer adlar:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ConcurrentTaskCount

En fazla eşzamanlı ağ çağrısını belirtir. Eşzamanlı ağ çağrılarının maksimum sayısını belirterek yerel CPU ve bant genişliği kullanımını kısıtlamak için eşzamanlılığı sınırlamak için bu parametreyi kullanabilirsiniz. Belirtilen değer mutlak bir sayıdır ve çekirdek sayısıyla çarpılmaz. Bu parametre, saniyede 100 kilobit gibi düşük bant genişliğine bağlı ortamlardaki ağ bağlantısı sorunlarını azaltmaya yardımcı olabilir. Varsayılan değer 10'dur.

Tür:Nullable<T>[Int32]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Context

Depolama bağlamını belirtir. Oluşturmak için New-AzStorageContext cmdlet'ini kullanabilirsiniz. Sorgu kapsayıcısı izinleri Depolama hesabı anahtarı izni gerektirdiğinden SAS Belirtecinden oluşturulan bir depolama bağlamı kullandığınızda kapsayıcı izinleri alınmaz.

Tür:IStorageContext
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ContinuationToken

Blob listesi için bir devamlılık belirteci belirtir.

Tür:BlobContinuationToken
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IncludeDeleted

Silinen kapsayıcıları dahil et, varsayılan olarak liste kapsayıcıları silinen kapsayıcıları içermez

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxCount

Bu cmdlet'in döndürdüğü en fazla nesne sayısını belirtir.

Tür:Nullable<T>[Int32]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Kapsayıcı adını belirtir. Kapsayıcı adı boşsa, cmdlet tüm kapsayıcıları listeler. Aksi takdirde, belirtilen ad veya normal ad deseni ile eşleşen tüm kapsayıcıları listeler.

Tür:String
Diğer adlar:N, Container
Position:0
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:True

-Prefix

Almak istediğiniz kapsayıcı veya kapsayıcıların adında kullanılan bir ön ek belirtir. "my" veya "test" gibi aynı dizeyle başlayan tüm kapsayıcıları bulmak için bunu kullanabilirsiniz.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServerTimeoutPerRequest

İstek için hizmet tarafı zaman aşımı aralığını saniye cinsinden belirtir. Belirtilen aralık hizmetin isteği işlemeden önce geçmesi durumunda depolama hizmeti bir hata döndürür.

Tür:Nullable<T>[Int32]
Diğer adlar:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

IStorageContext

Çıkışlar

AzureStorageContainer