Get-AzStorageContainer

Módulo:

Az.Storage Module

Lista os contêineres de armazenamento.

Sintaxe

ContainerName (Predefinição)

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 o contêiner de Armazenamento do Azure pelo 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 contêiner.

Exemplo 2: Obter contêiner de 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 container.

Exemplo 3: Listar contêiner de 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 do contêiner excluído, inclua: DeletedOn, RemainingRetentionDays. Os contêineres excluídos só existirão depois que o Container softdelete for ativado 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 tentará novamente a solicitação. Se este cmdlet não receber uma resposta bem-sucedida antes do intervalo passar, ele retornará um erro.

Propriedades dos parâmetros

Tipo:	Nullable<T>[Int32]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	ClientTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 da CPU e da 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 principal. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 kilobits por segundo. O valor padrão é 10.

Propriedades dos parâmetros

Tipo:	Nullable<T>[Int32]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 a partir do Token SAS, porque as permissões de contêiner de consulta exigem a permissão de chave de conta de armazenamento.

Propriedades dos parâmetros

Tipo:	IStorageContext
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-ContinuationToken

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

Propriedades dos parâmetros

Tipo:	Microsoft.Azure.Storage.Blob.BlobContinuationToken
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:	IAzureContextContainer
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-IncludeDeleted

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-MaxCount

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

Propriedades dos parâmetros

Tipo:	Nullable<T>[Int32]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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 dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	True
NãoMostrar:	False
Aliases:	N, Container

Conjuntos de parâmetros

ContainerName

Position:	0
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Prefix

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

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ContainerPrefix

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ServerTimeoutPerRequest

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

Propriedades dos parâmetros

Tipo:	Nullable<T>[Int32]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	ServerTimeoutPerRequestInSeconds

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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

Ligações Relacionadas

• New-AzStorageContainer
• Remove-AzStorageContainer
• Set-AzStorageContainerAcl