Get-AzStorageBlobByTag

  • 參考
模組:
Az.Storage

使用 Blob 標籤篩選 sql 運算式，列出跨容器的記憶體帳戶中的 Blob。

Syntax

Get-AzStorageBlobByTag
   -TagFilterSqlExpression <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-GetBlobProperty]
   [-Container <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

Get-Az 儲存體 BlobByTag Cmdlet 會跨容器列出記憶體帳戶中的 Blob，並搭配 Blob 標記篩選 sql 表達式。

範例

範例 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」 和 value “value1” 的標記，並取得 Blob 屬性。 請注意，若要使用參數 -GetBlobProperty 取得 Blob 屬性，每個 Blob 都需要額外的要求，因此 Cmdlet 會在有許多 Blob 時執行。

參數

-ClientTimeoutPerRequest

用戶端每個要求的運行時間上限，以秒為單位。

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

並行異步工作的總數量。 預設值為 10。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

容器名稱，指定此參數只傳回所有標記符合容器中搜尋表達式的 Blob。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Azure 儲存體 Context 物件

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

接續令牌。

Type:BlobContinuationToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GetBlobProperty

當 blob 依標記取得時，不包含 Blob Proeprties，請指定 tis 參數，以在每個 Blob 上取得具有額外要求的 Blob 屬性。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxCount

可傳回之 Blob 的最大計數。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

伺服器會以秒為單位針對每個要求逾時。

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TagFilterSqlExpression

篩選結果集，只包含標記符合指定表達式的 Blob。 請參閱 https://learn.microsoft.com/en-us/rest/api/storageservices/find-blobs-by-tags#remarks 中的詳細資料。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

輸入

IStorageContext

輸出

AzureStorageBlob