Get-AzStorageBlobContent
構文
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
バックグラウンドでコマンドレットを実行します。
パラメーターのプロパティ
パラメーター セット
(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 オブジェクト
パラメーターのプロパティ
パラメーター セット
BlobPipeline
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-CheckMd5
ダウンロードしたファイルの Md5 合計を確認するかどうかを指定します。
パラメーターのプロパティ
パラメーター セット
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 です。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Container
ダウンロードする BLOB を含むコンテナーの名前を指定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
ReceiveManual
配置: 1
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Context
BLOB コンテンツのダウンロード元となる Azure ストレージ アカウントを指定します。
New-AzStorageContext コマンドレットを使用して、ストレージ コンテキストを作成できます。
パラメーターのプロパティ
パラメーター セット
ReceiveManual
配置: Named
必須: False
パイプラインからの値: True
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
BlobPipeline
配置: Named
必須: False
パイプラインからの値: True
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
ContainerPipeline
配置: Named
必須: False
パイプラインからの値: True
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Destination
ダウンロードしたファイルを格納する場所を指定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: 経路
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Force
確認なしで既存のファイルを上書きします。
パラメーターのプロパティ
パラメーター セット
(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
出力
メモ
ローカル コンピューターの BLOB 名が無効な場合は、可能であれば、このコマンドレットによって自動的に解決されます。