Get-AzStorageContainer
Lista os contêineres de armazenamento.
Sintaxe
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>]
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.
Tipo: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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 predefinido é 10.
Tipo: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | IStorageContext |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-ContinuationToken
Especifica um token de continuação para a lista de blobs.
Tipo: | BlobContinuationToken |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-IncludeDeleted
Incluir contêineres excluídos, por padrão os contêineres de lista não incluirão contêineres excluídos
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MaxCount
Especifica o número máximo de objetos que esse cmdlet retorna.
Tipo: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | String |
Aliases: | N, Container |
Position: | 0 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | True |
-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".
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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.
Tipo: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
Saídas
Ligações Relacionadas
Azure PowerShell