Compartilhar via

Get-AzStorageContainer

Módulo:
Az.Storage Module

Lista os contêineres de armazenamento.

Sintaxe

ContainerName (Default) 

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

O cmdlet Get-AzStorageContainer lista os contêineres de armazenamento associados à conta de armazenamento no Azure.

Exemplos

Exemplo 1: Obter contêiner do Armazenamento do Azure por nome

Get-AzStorageContainer -Name container*

Este exemplo usa um caractere curinga para retornar uma lista de todos os contêineres com um nome que começa com o contêiner.

Exemplo 2: obter o contêiner do Armazenamento do Azure por prefixo de nome de contêiner

Get-AzStorageContainer -Prefix "container"

Este exemplo usa o parâmetro Prefix para retornar uma lista de todos os contêineres com um nome que começa com o contêiner.

Exemplo 3: Listar contêiner do Armazenamento do Azure, incluir contêineres excluídos

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

Este exemplo lista todos os contêineres de uma conta de armazenamento, incluindo contêineres excluídos. Em seguida, mostre as propriedades de contêiner excluídas, inclua: DeletedOn, RemainingRetentionDays. Contêineres excluídos só existirão após o softdelete de contêiner habilitado com Enable-AzStorageBlobDeleteRetentionPolicy.

Parâmetros

-ClientTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do cliente, em segundos, para uma solicitação de serviço. Se a chamada anterior falhar no intervalo especificado, esse cmdlet repetirá a solicitação. Se esse cmdlet não receber uma resposta bem-sucedida antes que o intervalo se esgote, esse cmdlet retornará um erro.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ClientTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConcurrentTaskCount

Especifica o máximo de chamadas de rede simultâneas. Você pode usar esse parâmetro para limitar a simultaneidade para limitar o uso local de CPU e largura de banda especificando o número máximo de chamadas de rede simultâneas. O valor especificado é uma contagem absoluta e não é multiplicado pela contagem de núcleos. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 quilobits por segundo. O valor padrão é 10.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Context

Especifica o contexto de armazenamento. Para criá-lo, você pode usar o cmdlet New-AzStorageContext. As permissões de contêiner não serão recuperadas quando você usar um contexto de armazenamento criado com base no Token SAS, pois as permissões de contêiner de consulta exigem permissão de chave de conta de armazenamento.

Propriedades do parâmetro

Tipo:IStorageContext
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ContinuationToken

Especifica um token de continuação para a lista de blobs.

Propriedades do parâmetro

Tipo:Microsoft.Azure.Storage.Blob.BlobContinuationToken
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludeDeleted

Incluir contêineres excluídos, por padrão, contêineres de lista não incluirão contêineres excluídos

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MaxCount

Especifica o número máximo de objetos que esse cmdlet retorna.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do contêiner. Se o nome do contêiner estiver vazio, o cmdlet listará todos os contêineres. Caso contrário, ele lista todos os contêineres que correspondem ao nome especificado ou ao padrão de nome regular.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:True
DontShow:False
Aliases:N, Contêiner

Conjuntos de parâmetros

ContainerName
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Prefix

Especifica um prefixo usado no nome do contêiner ou contêineres que você deseja obter. Você pode usar isso para localizar todos os contêineres que começam com a mesma cadeia de caracteres, como "my" ou "test".

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ContainerPrefix
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ServerTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do serviço, em segundos, para uma solicitação. Se o intervalo especificado ocorrer antes que o serviço processe a solicitação, o serviço de armazenamento retornará um erro.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ServerTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

IStorageContext

Saídas

AzureStorageContainer