Share via

Get-AzureStorageBlob

  • リファレンス
モジュール:
Azure.Storage

コンテナー内の BLOB を一覧表示します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

Get-AzureStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

説明

Get-AzureStorageBlob コマンドレットは、Azure ストレージ アカウント内の指定されたコンテナー内の BLOB を一覧表示します。

例

例 1: BLOB 名で BLOB を取得する

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Blob blob*

このコマンドでは、BLOB 名とワイルドカードを使用して BLOB を取得します。

例 2: パイプラインを使用して BLOB を取得する

PS C:\>Get-AzureStorageContainer -Name container* | Get-AzureStorageBlob

このコマンドでは、パイプラインを使用して BLOB を取得します。

例 3: 名前プレフィックスで BLOB を取得する

PS C:\>Get-AzureStorageBlob -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-AzureStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($Token -ne $Null)
PS C:\> Echo "Total $Total blobs in container $ContainerName"

この例では、 MaxCount パラメーターと ContinuationToken パラメーターを使用して、複数のバッチで Azure Storage BLOB を一覧表示します。 最初の 4 つのコマンドは、この例で使用する変数に値を割り当てます。

5 番目のコマンドは、Get-AzureStorageBlob コマンドレットを使用して BLOB を取得する Do-While ステートメントを指定します。 ステートメントには、$Token変数に格納されている継続トークンが含まれています。 $Tokenループの実行時に値が変更されます。 詳細を表示するには「Get-Help About_Do」を入力します。

最後のコマンドでは、Echo コマンドを使用して合計を表示します。

パラメーター

-Blob

ワイルドカード検索に使用できる名前または名前パターンを指定します。 BLOB 名が指定されていない場合、コマンドレットは指定されたコンテナー内のすべての BLOB を一覧表示します。 このパラメーターに値が指定されている場合、コマンドレットは、このパラメーターに一致する名前を持つすべての BLOB を一覧表示します。

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

-ClientTimeoutPerRequest

1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。

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

-ConcurrentTaskCount

同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。

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

-Container

コンテナーの名前を指定します。

Type:String
Aliases:N, Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Context

BLOB の一覧を取得する Azure ストレージ アカウントを指定します。 New-AzureStorageContext コマンドレットを使用して、ストレージ コンテキストを作成できます。

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

-ContinuationToken

BLOB リストの継続トークンを指定します。 このパラメーターと MaxCount パラメーターを使用して、複数のバッチ内の BLOB を一覧表示します。

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

-MaxCount

このコマンドレットが返すオブジェクトの最大数を指定します。

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

-Prefix

取得する BLOB 名のプレフィックスを指定します。 このパラメーターでは、正規表現またはワイルドカード文字を使用した検索はサポートされていません。 つまり、コンテナーに "My"、"MyBlob1"、および "MyBlob2" という名前の BLOB のみが含まれており、"-Prefix My*" を指定した場合、コマンドレットは BLOB を返しません。 ただし、"-Prefix My" を指定すると、コマンドレットは "My"、"MyBlob1"、および "MyBlob2" を返します。

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

-ServerTimeoutPerRequest

要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。

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

出力

AzureStorageBlob

メモ

  • 概要