Delen via

Get-AzStorageContainer

Module:
Az.Storage Module

Geeft een lijst weer van de opslagcontainers.

Syntaxis

ContainerName (Standaard) 

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

ContainerPrefix 

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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ClientTimeoutPerRequestInSeconds

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Context

Hiermee geeft u de opslagcontext op. Als u deze wilt maken, kunt u de cmdlet New-AzStorageContext gebruiken. 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.

Parametereigenschappen

Type:IStorageContext
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ContinuationToken

Hiermee geeft u een vervolgtoken voor de bloblijst.

Parametereigenschappen

Type:Microsoft.Azure.Storage.Blob.BlobContinuationToken
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IncludeDeleted

Verwijderde containers opnemen, standaard lijstcontainers bevatten geen verwijderde containers

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MaxCount

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

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:True
DontShow:False
Aliassen:N, Container

Parametersets

ContainerName
Position:0
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-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'.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ContainerPrefix
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ServerTimeoutPerRequestInSeconds

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

IStorageContext

Uitvoerwaarden

AzureStorageContainer