Get-AzStorageBlobByTag

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-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

이 명령은 이름이 "tag1"이고 값이 "value1"인 태그를 포함하는 스토리지 계정의 모든 Blob을 나열합니다.

예제 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 *

이 명령은 이름이 "tag1"이고 값이 "value1"인 태그를 포함하는 스토리지 계정의 모든 Blob을 나열하고 Blob 속성을 가져옵니다. 매개 변수 -GetBlobProperty를 사용하여 Blob 속성을 얻으려면 각 Blob에 추가 요청이 필요하므로 blob이 많을 때 cmdlet 실행이 표시됩니다.

매개 변수

-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 Storage 컨텍스트 개체

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가 포함되지 않으므로 각 Blob에 대한 추가 요청이 있는 Blob 속성을 가져오는 tis 매개 변수를 지정합니다.

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