Delen via

Get-AzStorageContainer

  • Referentie
Module:
Az.Storage

Geeft een lijst weer van de opslagcontainers.

Syntaxis

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

De cmdlet Get-AzStorageContainer bevat de opslagcontainers die zijn gekoppeld aan het opslagaccount in Azure.

Voorbeelden

Voorbeeld 1: Azure Storage-container op naam ophalen

Get-AzStorageContainer -Name container*

In dit voorbeeld wordt een jokerteken gebruikt om een lijst met alle containers te retourneren met een naam die begint met de container.

Voorbeeld 2: Azure Storage-container ophalen op containernaamvoorvoegsel

Get-AzStorageContainer -Prefix "container"

In dit voorbeeld wordt de parameter Voorvoegsel gebruikt om een lijst met alle containers te retourneren met een naam die begint met de container.

Voorbeeld 3: Azure Storage-container vermelden, verwijderde containers opnemen

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

In dit voorbeeld worden alle containers van een opslagaccount weergegeven, inclusief verwijderde containers. Geef vervolgens de eigenschappen van de verwijderde container weer, inclusief: DeletedOn, RemainingRetentionDays. Verwijderde containers bestaan alleen na ingeschakelde container softdelete met Enable-AzStorageBlobDeleteRetentionPolicy.

Parameters

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

Type:Nullable<T>[Int32]
Aliassen:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Hiermee geeft u de opslagcontext op. U kunt deze maken met de cmdlet New-AzStorageContext. De containermachtigingen worden niet opgehaald wanneer u een opslagcontext gebruikt die is gemaakt op basis van een SAS-token, omdat voor querycontainermachtigingen sleutelmachtigingen voor het opslagaccount zijn vereist.

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ContinuationToken

Hiermee geeft u een vervolgtoken voor de bloblijst.

Type:BlobContinuationToken
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IncludeDeleted

Verwijderde containers opnemen, standaard lijstcontainers bevatten geen verwijderde containers

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaxCount

Hiermee geeft u het maximum aantal objecten op dat door deze cmdlet wordt geretourneerd.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de containernaam. Als de containernaam leeg is, geeft de cmdlet alle containers weer. Anders worden alle containers vermeld die overeenkomen met de opgegeven naam of het normale naampatroon.

Type:String
Aliassen:N, Container
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Prefix

Hiermee geeft u een voorvoegsel op dat wordt gebruikt in de naam van de container of containers die u wilt ophalen. U kunt dit gebruiken om alle containers te vinden die beginnen met dezelfde tekenreeks, zoals 'mijn' of 'test'.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServerTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de servicezijde op, in seconden, voor een aanvraag. Als het opgegeven interval is verstreken voordat de service de aanvraag verwerkt, retourneert de opslagservice een fout.

Type:Nullable<T>[Int32]
Aliassen:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

IStorageContext

Uitvoerwaarden

AzureStorageContainer