Get-AzStorageContainer

Elenca i contenitori di archiviazione.

Sintassi

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

Descrizione

Il cmdlet Get-Az Archiviazione Container elenca i contenitori di archiviazione associati all'account di archiviazione in Azure.

Esempio

Esempio 1: Ottenere Archiviazione di Azure contenitore in base al nome

Get-AzStorageContainer -Name container*

In questo esempio viene usato un carattere jolly per restituire un elenco di tutti i contenitori con un nome che inizia con il contenitore.

Esempio 2: Ottenere Archiviazione di Azure contenitore in base al prefisso del nome del contenitore

Get-AzStorageContainer -Prefix "container"

In questo esempio viene usato il parametro Prefix per restituire un elenco di tutti i contenitori con un nome che inizia con il contenitore.

Esempio 3: Elencare Archiviazione di Azure contenitore, includere contenitori eliminati

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

Questo esempio elenca tutti i contenitori di un account di archiviazione, inclusi i contenitori eliminati. Visualizzare quindi le proprietà del contenitore eliminate, includere : DeletedOn, RemainingRetentionDays. I contenitori eliminati saranno presenti solo dopo l'abilitazione dell'eliminazione temporanea del contenitore con Enable-Az Archiviazione BlobDeleteRetentionPolicy.

Parametri

-ClientTimeoutPerRequest

Specifica l'intervallo di timeout lato client, espresso in secondi, per una richiesta di servizio. Se la chiamata precedente ha esito negativo nell'intervallo specificato, questo cmdlet ritenta la richiesta. Se questo cmdlet non riceve una risposta corretta prima della scadenza dell'intervallo, questo cmdlet restituisce un errore.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Specifica il numero massimo di chiamate di rete simultanee. È possibile usare questo parametro per limitare la concorrenza per limitare l'utilizzo della CPU e della larghezza di banda locali specificando il numero massimo di chiamate di rete simultanee. Il valore specificato è un conteggio assoluto e non viene moltiplicato per il numero di core. Questo parametro consente di ridurre i problemi di connessione di rete in ambienti a larghezza di banda ridotta, ad esempio 100 kilobit al secondo. Il valore predefinito è 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Specifica il contesto di archiviazione. Per crearlo, è possibile usare il cmdlet New-Az Archiviazione Context. Le autorizzazioni del contenitore non verranno recuperate quando si usa un contesto di archiviazione creato dal token di firma di accesso condiviso, perché le autorizzazioni del contenitore di query richiedono Archiviazione'autorizzazione della chiave dell'account.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Specifica un token di continuazione per l'elenco di BLOB.

Type:BlobContinuationToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

Includi contenitori eliminati, per impostazione predefinita i contenitori di elenco non includono contenitori eliminati

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxCount

Specifica il numero massimo di oggetti restituiti dal cmdlet.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome del contenitore. Se il nome del contenitore è vuoto, il cmdlet elenca tutti i contenitori. In caso contrario, elenca tutti i contenitori che corrispondono al nome specificato o al modello di nome normale.

Type:String
Aliases:N, Container
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Prefix

Specifica un prefisso usato nel nome del contenitore o dei contenitori da ottenere. È possibile usarlo per trovare tutti i contenitori che iniziano con la stessa stringa, ad esempio "my" o "test".

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Specifica l'intervallo di timeout sul lato servizio, espresso in secondi, per una richiesta. Se l'intervallo specificato è trascorso prima che il servizio elabori la richiesta, il servizio di archiviazione restituisce un errore.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

IStorageContext

Output

AzureStorageContainer