Sdílet prostřednictvím

Get-AzStorageContainer

  • Reference
Modul:
Az.Storage

Zobrazí seznam kontejnerů úložiště.

Syntaxe

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

Rutina Get-AzStorageContainer uvádí kontejnery úložiště přidružené k účtu úložiště v Azure.

Příklady

Příklad 1: Získání kontejneru Azure Storage podle názvu

Get-AzStorageContainer -Name container*

Tento příklad používá zástupný znak k vrácení seznamu všech kontejnerů s názvem, který začíná kontejnerem.

Příklad 2: Získání kontejneru Azure Storage podle předpony názvu kontejneru

Get-AzStorageContainer -Prefix "container"

Tento příklad používá parametr Prefix k vrácení seznamu všech kontejnerů s názvem, který začíná kontejnerem.

Příklad 3: Výpis kontejneru Azure Storage, zahrnutí odstraněných kontejnerů

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

Tento příklad obsahuje seznam všech kontejnerů účtu úložiště, včetně odstraněných kontejnerů. Potom zobrazte vlastnosti odstraněného kontejneru, včetně: DeletedOn, RemainingRetentionDays. Odstraněné kontejnery budou existovat pouze po povolení obnovitelného odstranění kontejneru s enable-AzStorageBlobDeleteRetentionPolicy.

Parametry

-ClientTimeoutPerRequest

Určuje interval časového limitu na straně klienta v sekundách pro jednu žádost o službu. Pokud předchozí volání v zadaném intervalu selže, tato rutina požadavek opakuje. Pokud tato rutina neobdrží úspěšnou odpověď před uplynutím intervalu, vrátí tato rutina chybu.

Typ:Nullable<T>[Int32]
Aliasy:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ConcurrentTaskCount

Určuje maximální počet souběžných síťových volání. Pomocí tohoto parametru můžete omezit souběžnost na omezení využití místního procesoru a šířky pásma zadáním maximálního počtu souběžných síťových volání. Zadaná hodnota je absolutní počet a nevynásobí se počtem jader. Tento parametr může pomoct snížit problémy s připojením k síti v prostředích s nízkou šířkou pásma, například 100 kilobitů za sekundu. Výchozí hodnota je 10.

Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Context

Určuje kontext úložiště. K jeho vytvoření můžete použít rutinu New-AzStorageContext. Oprávnění kontejneru se nenačtou, když použijete kontext úložiště vytvořený z tokenu SAS, protože oprávnění kontejneru dotazů vyžadují oprávnění ke klíči účtu úložiště.

Typ:IStorageContext
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ContinuationToken

Určuje token pokračování pro seznam objektů blob.

Typ:BlobContinuationToken
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IncludeDeleted

Zahrnout odstraněné kontejnery, ve výchozím nastavení kontejnery seznamů nebudou obsahovat odstraněné kontejnery.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxCount

Určuje maximální počet objektů, které tato rutina vrátí.

Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název kontejneru. Pokud je název kontejneru prázdný, zobrazí rutina seznam všech kontejnerů. V opačném případě zobrazí seznam všech kontejnerů, které odpovídají zadanému názvu nebo vzoru běžného názvu.

Typ:String
Aliasy:N, Container
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Prefix

Určuje předponu použitou v názvu kontejneru nebo kontejnerů, které chcete získat. Pomocí tohoto příkazu můžete najít všechny kontejnery, které začínají stejným řetězcem, například "my" nebo "test".

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerTimeoutPerRequest

Určuje interval časového limitu na straně služby v sekundách pro požadavek. Pokud zadaný interval uplynou před tím, než služba zpracuje požadavek, služba úložiště vrátí chybu.

Typ:Nullable<T>[Int32]
Aliasy:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

IStorageContext

Výstupy

AzureStorageContainer