Dela via

Get-AzStorageContainer

Modul:
Az.Storage Module

Visar en lista över lagringscontainrar.

Syntax

ContainerName (Standard) 

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

Cmdleten Get-AzStorageContainer visar de lagringscontainrar som är associerade med lagringskontot i Azure.

Exempel

Exempel 1: Hämta Azure Storage-container efter namn

Get-AzStorageContainer -Name container*

I det här exemplet används ett jokertecken för att returnera en lista över alla containrar med ett namn som börjar med containern.

Exempel 2: Hämta Azure Storage-container efter containernamnprefix

Get-AzStorageContainer -Prefix "container"

I det här exemplet används prefixparametern för att returnera en lista över alla containrar med ett namn som börjar med containern.

Exempel 3: Lista Azure Storage-container, inkludera borttagna containrar

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

I det här exemplet visas alla containrar för ett lagringskonto, inklusive borttagna containrar. Visa sedan egenskaperna för den borttagna containern, inklusive: DeletedOn, RemainingRetentionDays. Borttagna containrar finns bara efter aktiverad mjuk borttagning av container med Enable-AzStorageBlobDeleteRetentionPolicy.

Parametrar

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan i sekunder för en tjänstbegäran. Om det föregående anropet misslyckas i det angivna intervallet försöker den här cmdleten skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Context

Anger lagringskontexten. Om du vill skapa den kan du använda cmdleten New-AzStorageContext. Containerbehörigheterna hämtas inte när du använder en lagringskontext som skapats från SAS-token, eftersom behörigheter för frågecontainer kräver behörighet för lagringskontonyckel.

Parameteregenskaper

Typ:IStorageContext
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ContinuationToken

Anger en fortsättningstoken för bloblistan.

Parameteregenskaper

Typ:Microsoft.Azure.Storage.Blob.BlobContinuationToken
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IncludeDeleted

Inkludera borttagna containrar, som standard innehåller inte listcontainrar borttagna containrar

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MaxCount

Anger det maximala antalet objekt som den här cmdleten returnerar.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Anger containernamnet. Om containernamnet är tomt visar cmdleten alla containrar. Annars visas alla containrar som matchar det angivna namnet eller det vanliga namnmönstret.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False
Alias:N, Container

Parameteruppsättningar

ContainerName
Position:0
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Prefix

Anger ett prefix som används i namnet på den container eller de containrar som du vill hämta. Du kan använda detta för att hitta alla containrar som börjar med samma sträng, till exempel "my" eller "test".

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ContainerPrefix
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ServerTimeoutPerRequest

Anger tidsgränsen för tjänstsidan i sekunder för en begäran. Om det angivna intervallet förflutit innan tjänsten bearbetar begäran returnerar lagringstjänsten ett fel.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

IStorageContext

Utdata

AzureStorageContainer