你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Get-AzStorageBlobByTag
使用 blob 标记筛选器 sql 表达式列出存储帐户中的 blob。
语法
Get-AzStorageBlobByTag
-TagFilterSqlExpression <String>
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-GetBlobProperty]
[-Container <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
说明
Get-AzStorageBlobByTag cmdlet 使用 blob 标记筛选器 sql 表达式列出跨容器的存储帐户中的 blob。
示例
示例 1:列出所有 Blob 与容器中的特定 Blob 标记匹配。
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
此命令列出存储帐户中的所有 blob,其中包含名为“tag1”和值“value1”的标记。
示例 2:列出特定容器中的 Blob 并匹配特定 Blob 标记
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
此命令列出容器中的 Blob,并匹配特定的 Blob 标记。
示例 3:列出所有 blob 与特定 Blob 标记匹配,跨容器,并获取 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 *
此命令列出存储帐户中的所有 blob,其中包含名为“tag1”和值“value1”的标记,并获取 Blob 属性。 请注意,若要获取具有参数 -GetBlobProperty 的 Blob 属性,每个 Blob 都需要一个额外的请求,因此 cmdlet 在有许多 blob 时运行。
参数
-ClientTimeoutPerRequest
客户端每个请求的最大执行时间(以秒为单位)。
类型: | Nullable<T>[Int32] |
别名: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ConcurrentTaskCount
并发异步任务的总数。 默认值为 10。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Container
容器名称,指定此参数仅返回其标记与容器中的搜索表达式匹配的所有 blob。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Context
Azure 存储上下文对象
类型: | IStorageContext |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-ContinuationToken
继续标记。
类型: | BlobContinuationToken |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-GetBlobProperty
由于 blob 按标记获取时不包含 blob 代理,请指定 tis 参数以获取 Blob 属性,并在每个 Blob 上附加请求。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-MaxCount
可返回的 Blob 的最大计数。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ServerTimeoutPerRequest
服务器为每个请求超时(以秒为单位)。
类型: | Nullable<T>[Int32] |
别名: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TagFilterSqlExpression
筛选结果集以仅包含其标记与指定表达式匹配的 blob。 请参阅 https://learn.microsoft.com/en-us/rest/api/storageservices/find-blobs-by-tags#remarks 中的详细信息。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |