Get-AzStorageBlobContent

模組:

Az.Storage Module

下載儲存體 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>]

Description

Get-AzStorageBlobContent Cmdlet 會下載指定的儲存體 Blob。 如果 Blob 名稱對本機電腦無效，此 Cmdlet 會盡可能自動解析它。

範例

範例 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 之外還需要持有人權杖才能下載，則 Cmdlet 會嘗試產生具有伺服器傳回物件和登入 AAD 使用者認證的持有人權杖，然後使用 Sas Uri 和持有人權杖下載 Blob。

參數

-AbsoluteUri

要從中下載的 Blob URI。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	Uri, BlobUri

參數集

UriPipeline

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-AsJob

在背景中執行 cmdlet。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Blob

指定要下載的 Blob 名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ReceiveManual

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ContainerPipeline

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BlobBaseClient

BlobBaseClient 物件

參數屬性

類型:	BlobBaseClient
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

BlobPipeline

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-CheckMd5

指定是否要檢查下載檔案的 Md5 總和。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ReceiveManual

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

BlobPipeline

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ContainerPipeline

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ClientTimeoutPerRequest

指定一個服務要求的用戶端逾時間隔 （以秒為單位）。 如果上一個呼叫在指定的間隔內失敗，則此 Cmdlet 會重試要求。 如果此 Cmdlet 在間隔經過之前未收到成功的回應，則此 Cmdlet 會傳回錯誤。

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	ClientTimeoutPerRequestInSeconds

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CloudBlob

指定雲端 Blob。 若要取得 CloudBlob 物件，請使用 Get-AzStorageBlob Cmdlet。

參數屬性

類型:	Microsoft.Azure.Storage.Blob.CloudBlob
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	ICloudBlob

參數集

BlobPipeline

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-CloudBlobContainer

指定來自 Azure 儲存體用戶端程式庫的 CloudBlobContainer 物件。 您可以建立它或使用 Get-AzStorageContainer Cmdlet。

參數屬性

類型:	Microsoft.Azure.Storage.Blob.CloudBlobContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ContainerPipeline

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ConcurrentTaskCount

指定並行網路呼叫數上限。 您可以使用此參數來限制並行，以指定並行網路呼叫數目上限，以節流本機 CPU 和頻寬使用量。 指定的值是絕對計數，不會乘以核心計數。 此參數有助於減少低頻寬環境下的網路連線問題，例如每秒 100 KB。 預設值為 10。

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Container

指定具有您要下載之 Blob 的容器名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ReceiveManual

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Context

指定您要從中下載 Blob 內容的 Azure 儲存體帳戶。 您可以使用 New-AzStorageContext Cmdlet 來建立儲存體內容。

參數屬性

類型:	IStorageContext
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ReceiveManual

Position:	Named
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

BlobPipeline

Position:	Named
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

ContainerPipeline

Position:	Named
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Destination

指定儲存下載檔案的位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	路徑

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Force

覆寫現有檔案而不進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ServerTimeoutPerRequest

指定要求的服務端逾時間隔 （以秒為單位）。 如果在服務處理要求之前經過指定的間隔，儲存體服務會傳回錯誤。

參數屬性

類型:	Nullable<T>[Int32]
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	ServerTimeoutPerRequestInSeconds

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-TagCondition

選用標籤運算式陳述式，用於檢查匹配條件。 當 Blob 標籤不符合指定的運算式時，Blob 要求將會失敗。 詳情請參閱 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-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 名稱對本機電腦無效，此 Cmdlet 會自動解析它 （如果可能的話）。

相關連結

• Set-AzStorageBlobContent
• Get-AzStorageBlob
• Remove-AzStorageBlob