Bagikan melalui

Get-AzStorageContainer

  • Referensi
Modul:
Az.Storage

Mencantumkan kontainer penyimpanan.

Sintaks

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

Deskripsi

Cmdlet Get-AzStorageContainer mencantumkan kontainer penyimpanan yang terkait dengan akun penyimpanan di Azure.

Contoh

Contoh 1: Mendapatkan kontainer Azure Storage berdasarkan nama

Get-AzStorageContainer -Name container*

Contoh ini menggunakan karakter kartubebas untuk mengembalikan daftar semua kontainer dengan nama yang dimulai dengan kontainer.

Contoh 2: Mendapatkan kontainer Azure Storage berdasarkan awalan nama kontainer

Get-AzStorageContainer -Prefix "container"

Contoh ini menggunakan parameter Awalan untuk mengembalikan daftar semua kontainer dengan nama yang dimulai dengan kontainer.

Contoh 3: Mencantumkan kontainer Azure Storage, termasuk kontainer yang dihapus

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

Contoh ini mencantumkan semua kontainer akun penyimpanan, termasuk kontainer yang dihapus. Kemudian tampilkan properti kontainer yang dihapus, termasuk : DeletedOn, RemainingRetentionDays. Kontainer yang dihapus hanya akan ada setelah softdelete Kontainer yang diaktifkan dengan Enable-AzStorageBlobDeleteRetentionPolicy.

Parameter

-ClientTimeoutPerRequest

Menentukan interval waktu habis sisi klien, dalam hitungan detik, untuk satu permintaan layanan. Jika panggilan sebelumnya gagal dalam interval yang ditentukan, cmdlet ini akan mencoba kembali permintaan. Jika cmdlet ini tidak menerima respons yang berhasil sebelum interval berlalu, cmdlet ini mengembalikan kesalahan.

Jenis:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ConcurrentTaskCount

Menentukan panggilan jaringan bersamaan maksimum. Anda dapat menggunakan parameter ini untuk membatasi konkurensi untuk membatasi penggunaan CPU dan bandwidth lokal dengan menentukan jumlah maksimum panggilan jaringan bersamaan. Nilai yang ditentukan adalah jumlah absolut dan tidak dikalikan dengan jumlah inti. Parameter ini dapat membantu mengurangi masalah koneksi jaringan di lingkungan bandwidth rendah, seperti 100 kilobit per detik. Nilai defaultnya adalah 10.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Context

Menentukan konteks penyimpanan. Untuk membuatnya, Anda dapat menggunakan cmdlet New-AzStorageContext. Izin kontainer tidak akan diambil saat Anda menggunakan konteks penyimpanan yang dibuat dari Token SAS, karena izin kontainer kueri memerlukan izin kunci akun Penyimpanan.

Jenis:IStorageContext
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ContinuationToken

Menentukan token kelanjutan untuk daftar blob.

Jenis:BlobContinuationToken
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-IncludeDeleted

Menyertakan kontainer yang dihapus, secara default, kontainer daftar tidak akan menyertakan kontainer yang dihapus

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-MaxCount

Menentukan jumlah maksimum objek yang dikembalikan cmdlet ini.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Name

Menentukan nama kontainer. Jika nama kontainer kosong, cmdlet mencantumkan semua kontainer. Jika tidak, ini mencantumkan semua kontainer yang cocok dengan nama yang ditentukan atau pola nama reguler.

Jenis:String
Alias:N, Container
Position:0
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:True

-Prefix

Menentukan awalan yang digunakan dalam nama kontainer atau kontainer yang ingin Anda dapatkan. Anda dapat menggunakan ini untuk menemukan semua kontainer yang dimulai dengan string yang sama, seperti "my" atau "test".

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-ServerTimeoutPerRequest

Menentukan interval waktu habis sisi layanan, dalam hitungan detik, untuk permintaan. Jika interval yang ditentukan berlalu sebelum layanan memproses permintaan, layanan penyimpanan mengembalikan kesalahan.

Jenis:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

IStorageContext

Output

AzureStorageContainer