Get-AzStorageBlobByTag
Lista blobs em uma conta de armazenamento em contêineres, com uma expressão sql de filtro de tag blob.
Sintaxe
Default (Predefinição)
Get-AzStorageBlobByTag
-TagFilterSqlExpression <String>
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-GetBlobProperty]
[-Container <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Description
O cmdlet Get-AzStorageBlobByTag lista blobs em uma conta de armazenamento entre contêineres, com uma expressão sql de filtro de marca de blob.
Exemplos
Exemplo 1: Liste todos os blobs que correspondem a uma tag de blob específica, entre contêineres.
Get-AzStorageBlobByTag -TagFilterSqlExpression """tag1""='value1'" -Context $ctx
AccountName: storageaccountname, ContainerName: containername1
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
testblob False
testblob2 False
AccountName: storageaccountname, ContainerName: containername2
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
testblob3 False
testblob4 False
Este comando lista todos os blobs em uma conta de armazenamento, que contém uma tag com nome "tag1" e valor "value1".
Exemplo 2: Listar blobs em um contêiner específico e corresponder a uma tag de blob específica
Get-AzStorageBlobByTag -Container 'containername' -TagFilterSqlExpression """tag1""='value1'" -Context $ctx
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
test1 False
test2 False
Este comando lista blobs em um contêiner e corresponde a uma tag de blob específica.
Exemplo 3: Liste todos os blobs que correspondam a uma tag de blob específica, entre contêineres, e obtenha as propriedades de blob.
Get-AzStorageBlobByTag -TagFilterSqlExpression """tag1""='value1'" -GetBlobProperty
AccountName: storageaccountname, ContainerName: containername1
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
testblob BlockBlob 2097152 application/octet-stream 2020-07-23 09:35:02Z Hot False 2020-07-23T09:35:02.8527357Z *
testblob2 BlockBlob 1048012 application/octet-stream 2020-07-23 09:35:05Z Hot False 2020-07-23T09:35:05.2504530Z *
AccountName: storageaccountname, ContainerName: containername2
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
testblob3 BlockBlob 100 application/octet-stream 2020-07-01 09:55:14Z Hot False 2020-07-01T09:55:14.6507341Z *
testblob4 BlockBlob 2024 application/octet-stream 2020-07-01 09:42:11Z Hot False 2020-07-01T09:42:11.4283807Z *
Este comando lista todos os blobs em uma conta de armazenamento, que contém uma tag com nome "tag1" e valor "value1", e obtém as propriedades de blob.
Observe que, para obter propriedades de blob com o parâmetro -GetBlobProperty, cada blob precisará de uma solicitação adicional, para que as execuções do cmdlet sejam exibidas quando houver muitos blobs.
Parâmetros
-ClientTimeoutPerRequest
O tempo máximo de execução do lado do cliente para cada solicitação em segundos.
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
A quantidade total de tarefas assíncronas simultâneas.
O valor predefinido é 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
-Container
Nome do contêiner, especifique esse parâmetro para retornar apenas todos os blobs cujas tags correspondam a uma expressão de pesquisa no contêiner.
Propriedades dos parâmetros
Tipo: String
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
Armazenamento do Azure Context Object
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
Token de continuação.
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, conta, inquilino e subscrição 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
-GetBlobProperty
Como os blobs get by tag não contêm propriedades de blob, especifique o parâmetro tis para obter propriedades de blob com uma solicitação adicional em cada blob.
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
A contagem máxima das bolhas que podem retornar.
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
-ServerTimeoutPerRequest
O tempo limite do servidor para cada solicitação em segundos.
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
-TagFilterSqlExpression
Filtra o conjunto de resultados para incluir apenas blobs cujas tags correspondam à expressão especificada.
Veja os detalhes em https://learn.microsoft.com/en-us/rest/api/storageservices/find-blobs-by-tags#remarks .
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True 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 .
Saídas
