Get-AzStorageBlobContent

模組:

Az.Storage

下載記憶體 Blob。

語法

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

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

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

Get-AzStorageBlobContent
   [-Destination <String>]
   -AbsoluteUri <String>
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-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 使用者 credentail，然後同時下載具有 Sas Uri 和持有人令牌的 Blob。

參數

-AbsoluteUri

要從下載的 Blob URI。

類型:	String
別名:	Uri, BlobUri
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-AsJob

在背景中執行 Cmdlet。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Blob

指定要下載的 Blob 名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-BlobBaseClient

BlobBaseClient 物件

類型:	BlobBaseClient
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-CheckMd5

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

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClientTimeoutPerRequest

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

類型:	Nullable<T>[Int32]
別名:	ClientTimeoutPerRequestInSeconds
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CloudBlob

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

類型:	CloudBlob
別名:	ICloudBlob
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-CloudBlobContainer

從 Azure 記憶體用戶端連結庫指定 CloudBlobContainer 物件。 您可以建立它或使用 Get-AzStorageContainer Cmdlet。

類型:	CloudBlobContainer
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ConcurrentTaskCount

指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限，使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數，不會乘以核心計數。 此參數可協助減少低頻寬環境中的網路連線問題，例如每秒 100 千位。 預設值為 10。

類型:	Nullable<T>[Int32]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Container

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

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Context

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

類型:	IStorageContext
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

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

類型:	IAzureContextContainer
別名:	AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Destination

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

類型:	String
別名:	Path
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

在不確認的情況下覆寫現有的檔案。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServerTimeoutPerRequest

指定要求的服務端超時時間間隔，以秒為單位。 如果指定的間隔在服務處理要求之前經過，則記憶體服務會傳回錯誤。

類型:	Nullable<T>[Int32]
別名:	ServerTimeoutPerRequestInSeconds
Position:	Named
預設值:	None
必要:	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
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

CloudBlob

CloudBlobContainer

IStorageContext

輸出

AzureStorageBlob

備註

• 如果本機電腦 Blob 名稱無效，則此 Cmdlet 會盡可能自動解決它。

相關連結

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