Get-AzStorageBlob
コンテナー内の BLOB を一覧表示します。
構文
Get-AzStorageBlob
[[-Blob] <String>]
[-Container] <String>
[-IncludeDeleted]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzStorageBlob
[-Blob] <String>
[-Container] <String>
[-IncludeDeleted]
[-IncludeTag]
-SnapshotTime <DateTimeOffset>
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzStorageBlob
[-Blob] <String>
[-Container] <String>
[-IncludeDeleted]
[-IncludeTag]
-VersionId <String>
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] Get-AzStorageBlob
[-Prefix <String>]
[-Container] <String>
[-IncludeDeleted]
[-IncludeVersion]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] 説明
Get-AzStorageBlob コマンドレットは、Azure ストレージ アカウント内の指定されたコンテナー内の BLOB を一覧表示します。
例
例 1: BLOB 名で BLOB を取得する
PS C:\>Get-AzStorageBlob -Container "ContainerName" -Blob blob*このコマンドでは、BLOB 名とワイルドカードを使用して BLOB を取得します。
例 2: パイプラインを使用してコンテナー内の BLOB を取得する
PS C:\>Get-AzStorageContainer -Name container* | Get-AzStorageBlob -IncludeDeleted
Container Uri: https://storageaccountname.blob.core.windows.net/container1
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted
---- -------- ------ ----------- ------------ ---------- ------------ ---------
test1 BlockBlob 403116 application/octet-stream 2017-11-08 07:53:19Z 2017-11-08 08:19:32Z True
test1 BlockBlob 403116 application/octet-stream 2017-11-08 09:00:29Z True
test2 BlockBlob 403116 application/octet-stream 2017-11-08 07:53:00Z Falseこのコマンドは、パイプラインを使用して、コンテナー内のすべての BLOB (削除済み状態の BLOB を含む) を取得します。
例 3: 名前プレフィックスで BLOB を取得する
PS C:\>Get-AzStorageBlob -Container "ContainerName" -Prefix "blob"このコマンドでは、名前プレフィックスを使用して BLOB を取得します。
例 4: 複数のバッチで BLOB を一覧表示する
PS C:\>$MaxReturn = 10000
PS C:\> $ContainerName = "abc"
PS C:\> $Total = 0
PS C:\> $Token = $Null
PS C:\> do
{
$Blobs = Get-AzStorageBlob -Container $ContainerName -MaxCount $MaxReturn -ContinuationToken $Token
$Total += $Blobs.Count
if($Blobs.Length -le 0) { Break;}
$Token = $Blobs[$blobs.Count -1].ContinuationToken;
}
While ($null -ne $Token)
PS C:\> Echo "Total $Total blobs in container $ContainerName"この例では、 MaxCount パラメーターと ContinuationToken パラメーターを使用して、複数のバッチで Azure Storage BLOB を一覧表示します。
最初の 4 つのコマンドは、この例で使用する変数に値を割り当てます。
5 番目のコマンドでは、Get-AzStorageBlob コマンドレットを使用して BLOB を取得する Do-While ステートメントを指定します。
ステートメントには、$Token変数に格納されている継続トークンが含まれます。
$Tokenは、ループの実行時に値を変更します。
詳細を表示するには「Get-Help About_Do」を入力します。
最後のコマンドでは、 Echo コマンドを使用して合計を表示します。
例 5: コンテナー内のすべての BLOB を取得する (BLOB バージョンを含む)
PS C:\>Get-AzStorageBlob -Container "containername" -IncludeVersion
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
blob1 BlockBlob 2097152 application/octet-stream 2020-07-06 06:56:06Z Hot False 2020-07-06T06:56:06.2432658Z
blob1 BlockBlob 2097152 application/octet-stream 2020-07-06 06:56:06Z Hot 2020-07-06T06:56:06.8588431Z False
blob1 BlockBlob 2097152 application/octet-stream 2020-07-06 06:56:06Z Hot False 2020-07-06T06:56:06.8598431Z *
blob2 BlockBlob 2097152 application/octet-stream 2020-07-03 16:19:16Z Hot False 2020-07-03T16:19:16.2883167Z
blob2 BlockBlob 2097152 application/octet-stream 2020-07-03 16:19:35Z Hot False 2020-07-03T16:19:35.2381110Z *このコマンドは、コンテナーに含まれる BLOB バージョンのすべての BLOB を取得します。
例 6: 1 つの BLOB バージョンを取得する
PS C:\> Get-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
blob2 BlockBlob 2097152 application/octet-stream 2020-07-03 16:19:16Z Hot False 2020-07-03T16:19:16.2883167Zこのコマンドは、VersionId を持つ 1 つの BLOB バージョンを取得します。
例 7: 1 つの BLOB スナップショットを取得する
PS C:\> Get-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
blob1 BlockBlob 2097152 application/octet-stream 2020-07-06 06:56:06Z Hot 2020-07-06T06:56:06.8588431Z Falseこのコマンドは、SnapshotTime を使用して 1 つの BLOB スナップショットを取得します。
例 8: BLOB インクルード BLOB タグを取得する
PS C:\> $blobs = Get-AzStorageBlob -Container "containername" -IncludeTag
PS C:\> $blobs
AccountName: storageaccountname, ContainerName: containername
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 2097152 application/octet-stream 2020-07-23 09:35:04Z Hot False 2020-07-23T09:35:04.0856187Z *
PS C:\> $blobs[0].Tags
Name Value
---- -----
tag1 value1
tag2 value2このコマンドは、BLOB タグを持つコンテナーの BLOB を一覧表示し、最初の BLOB のタグを表示します。
例 9: BLOB タグ条件を持つ 1 つの BLOB を取得する
PS C:\> Get-AzStorageBlob -Container "containername" -Blob testblob -TagCondition """tag1""='value1'"
AccountName: storageaccountname, ContainerName: containername
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 *このコマンドは、BLOB タグ条件を持つ 1 つの BLOB を取得します。 このコマンドレットは、BLOB に "tag1" という名前と値 "value1" のタグが含まれている場合にのみ成功します。それ以外の場合、コマンドレットはエラー コード 412 で失敗します。
パラメーター
ワイルドカード検索に使用できる名前または名前パターンを指定します。 BLOB 名が指定されていない場合、コマンドレットは指定されたコンテナー内のすべての BLOB を一覧表示します。 このパラメーターに値が指定されている場合、コマンドレットは、このパラメーターに一致する名前を持つすべての BLOB を一覧表示します。 このパラメーターは、文字列内の任意の場所でワイルドカードをサポートします。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前回の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 このコマンドレットは、間隔が経過する前に正常な応答を受け取らない場合、このコマンドレットはエラーを返します。
| Type: | Nullable<T>[Int32] |
| Aliases: | ClientTimeoutPerRequestInSeconds |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定された値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなど、低帯域幅環境でのネットワーク接続の問題を軽減するのに役立ちます。 既定値は 10 です。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コンテナーの名前を指定します。
| Type: | String |
| Aliases: | N, Name |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
BLOB の一覧を取得する Azure ストレージ アカウントを指定します。 New-AzStorageContext コマンドレットを使用して、ストレージ コンテキストを作成できます。
| Type: | IStorageContext |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
BLOB リストの継続トークンを指定します。 このパラメーターと MaxCount パラメーターを使用して、複数のバッチ内の BLOB を一覧表示します。
| Type: | BlobContinuationToken |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
削除済み BLOB を含めます。既定では、BLOB の取得には削除された BLOB は含まれません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
BLOB タグを含めます。既定では、BLOB の取得には BLOB タグは含まれません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
BLOB のバージョンは、このパラメーターが存在する場合にのみ一覧表示されます。既定では、BLOB の取得には BLOB のバージョンは含まれません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このコマンドレットが返すオブジェクトの最大数を指定します。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
取得する BLOB 名のプレフィックスを指定します。 このパラメーターでは、検索に正規表現またはワイルドカード文字を使用することはできません。 つまり、コンテナーに "My"、"MyBlob1"、および "MyBlob2" という名前の BLOB のみが含まれており、"-Prefix My*" を指定した場合、コマンドレットは BLOB を返しません。 ただし、"-Prefix My" を指定すると、コマンドレットは "My"、"MyBlob1"、"MyBlob2" を返します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定された間隔が経過すると、ストレージ サービスはエラーを返します。
| Type: | Nullable<T>[Int32] |
| Aliases: | ServerTimeoutPerRequestInSeconds |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Blob SnapshotTime
| Type: | Nullable<T>[DateTimeOffset] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
一致条件を確認するオプションの Tag 式ステートメント。 BLOB タグが指定された式と一致しない場合、BLOB 要求は失敗します。 詳細については、 https://docs.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations を確認してください。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Blob VersionId
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
出力
関連リンク
フィードバック
フィードバックの送信と表示