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 |
입력
출력
Azure PowerShell
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기