次の方法で共有


Get-AzStorageBlobContent

ストレージ BLOB をダウンロードします。

構文

ReceiveManual (既定)

Get-AzStorageBlobContent
    [-Blob] <String>
    [-Container] <String>
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipeline

Get-AzStorageBlobContent
    -CloudBlob <CloudBlob>
    [-BlobBaseClient <BlobBaseClient>]
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ContainerPipeline

Get-AzStorageBlobContent
    [-Blob] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UriPipeline

Get-AzStorageBlobContent
    -AbsoluteUri <String>
    [-Destination <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Get-AzStorageBlobContent コマンドレットは、指定されたストレージ BLOB をダウンロードします。 BLOB 名がローカル コンピューターに対して有効でない場合、可能であれば、このコマンドレットによって自動的に解決されます。

例 1: 名前で BLOB コンテンツをダウンロードする

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

このコマンドは、名前で BLOB をダウンロードします。

例 2: パイプラインを使用して BLOB コンテンツをダウンロードする

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

このコマンドでは、パイプラインを使用して BLOB コンテンツを検索およびダウンロードします。

例 3: パイプラインとワイルドカード文字を使用して BLOB コンテンツをダウンロードする

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

この例では、アスタリスクワイルドカード文字とパイプラインを使用して、BLOB コンテンツを検索してダウンロードします。

例 4: BLOB オブジェクトを取得して変数に保存し、BLOB オブジェクトを含む BLOB コンテンツをダウンロードする

$blob = Get-AzStorageBlob -Container containername -Blob blobname
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

この例では、最初に BLOB オブジェクトを取得し、変数に保存してから、BLOB オブジェクトを含む BLOB コンテンツをダウンロードします。

例 5: BLOB URI を使用して BLOB コンテンツをダウンロードする

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

この例では、URI を含む BLOB コンテンツをダウンロードします。Uri には Sas トークンを含む URI を指定できます。 BLOB がマネージド ディスク アカウント上にあり、サーバーでダウンロードするために Sas Uri 以外のベアラー トークンが必要な場合、コマンドレットは、サーバーから返された対象ユーザーとログイン AAD ユーザー資格情報を使用してベアラー トークンを生成し、Sas Uri とベアラー トークンの両方を含む BLOB をダウンロードしようとします。

パラメーター

-AbsoluteUri

ダウンロードする BLOB URI。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:うり, BlobUri

パラメーター セット

UriPipeline
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-AsJob

バックグラウンドでコマンドレットを実行します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Blob

ダウンロードする BLOB の名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ReceiveManual
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ContainerPipeline
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BlobBaseClient

BlobBaseClient オブジェクト

パラメーターのプロパティ

型:BlobBaseClient
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

BlobPipeline
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-CheckMd5

ダウンロードしたファイルの Md5 合計を確認するかどうかを指定します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ReceiveManual
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
BlobPipeline
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ContainerPipeline
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ClientTimeoutPerRequest

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

パラメーターのプロパティ

型:

Nullable<T>[Int32]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ClientTimeoutPerRequestInSeconds

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CloudBlob

クラウド BLOB を指定します。 CloudBlob オブジェクトを取得するには、Get-AzStorageBlob コマンドレットを使用します。

パラメーターのプロパティ

型:Microsoft.Azure.Storage.Blob.CloudBlob
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ICloudBlob

パラメーター セット

BlobPipeline
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-CloudBlobContainer

Azure ストレージ クライアント ライブラリから CloudBlobContainer オブジェクトを指定します。 これを作成することも、Get-AzStorageContainer コマンドレットを使用することもできます。

パラメーターのプロパティ

型:Microsoft.Azure.Storage.Blob.CloudBlobContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ContainerPipeline
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ConcurrentTaskCount

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

パラメーターのプロパティ

型:

Nullable<T>[Int32]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Container

ダウンロードする BLOB を含むコンテナーの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ReceiveManual
配置:1
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Context

BLOB コンテンツのダウンロード元となる Azure ストレージ アカウントを指定します。 New-AzStorageContext コマンドレットを使用して、ストレージ コンテキストを作成できます。

パラメーターのプロパティ

型:IStorageContext
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ReceiveManual
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
BlobPipeline
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
ContainerPipeline
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Destination

ダウンロードしたファイルを格納する場所を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:経路

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Force

確認なしで既存のファイルを上書きします。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ServerTimeoutPerRequest

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

パラメーターのプロパティ

型:

Nullable<T>[Int32]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ServerTimeoutPerRequestInSeconds

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TagCondition

一致条件を確認するオプションの Tag 式ステートメント。 BLOB タグが指定された式と一致しない場合、BLOB 要求は失敗します。 詳細については、 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations を確認してください。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.CloudBlobContainer

IStorageContext

出力

AzureStorageBlob

メモ

  • ローカル コンピューターの BLOB 名が無効な場合は、可能であれば、このコマンドレットによって自動的に解決されます。