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 コマンドレットは、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 を一覧表示します。この 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 に追加の要求が必要になるため、多くの 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 Storage 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 の特性が含まれていないので、各 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
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示