Set-AzStorageBlobContent

  • 參考
模組:
Az.Storage

將本機檔案上傳至 Azure 儲存體 Blob。

Syntax

Set-AzStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-Az 儲存體 BlobContent Cmdlet 會將本機檔案上傳至 Azure 儲存體 Blob。

範例

範例 1：上傳具名檔案

Set-AzStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

此命令會將名為 PlanningData 的檔案上傳至名為 Planning2015 的 Blob。

範例 2：上傳目前資料夾下的所有檔案

Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -Container "ContosoUploads"

此命令使用核心 Windows PowerShell Cmdlet Get-ChildItem 來取得目前資料夾和子資料夾中的所有檔案，然後使用管線運算符將它們傳遞至目前的 Cmdlet。 Set-Az 儲存體 BlobContent Cmdlet 會將檔案上傳至名為 ContosoUploads 的容器。

範例 3：覆寫現有的 Blob

Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"

此命令會使用 Get-Az 儲存體 Blob Cmdlet 取得 ContosoUploads 容器中名為 Planning2015 的 Blob，然後將該 Blob 傳遞至目前的 Cmdlet。 命令會將名為 ContosoPlanning 的檔案上傳為 Planning2015。 此命令未指定 Force 參數。 命令會提示您進行確認。 如果您確認命令，Cmdlet 會覆寫現有的 Blob。

範例 4：使用管線將檔案上傳至容器

Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

此命令會使用 Get-Az 儲存體 Container Cmdlet 取得開頭為 ContosoUpload 字串的容器，然後將該 Blob 傳遞至目前的 Cmdlet。 命令會將名為 ContosoPlanning 的檔案上傳為 Planning2015。

範例 5：將檔案上傳至具有元數據的分頁 Blob，並將 進階版 PageBlobTier 作為 P10

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

第一個命令會建立包含 Blob 元數據的哈希表，並將該哈希表儲存在$Metadata變數中。 第二個命令會將名為 ContosoPlanning 的檔案上傳至名為 ContosoUploads 的容器。 Blob 包含儲存在 $Metadata 中的元數據，並將 進階版 PageBlobTier 作為 P10。

範例 6：將檔案上傳至具有指定 Blob 屬性的 Blob，並將 StandardBlobTier 設定為非經常性

$filepath = "c:\temp\index.html"
Set-AzStorageBlobContent -File $filepath -Container "contosouploads" -Properties @{"ContentType" = [System.Web.MimeMapping]::GetMimeMapping($filepath); "ContentMD5" = "i727sP7HigloQDsqadNLHw=="} -StandardBlobTier Cool

AccountName: storageaccountname, ContainerName: contosouploads

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
index.html           BlockBlob 403116          text/html                      2020-09-22 08:06:53Z Cool                                    False

此命令會將 c：\temp\index.html檔案上傳至名為 contosouploads 且具有指定 Blob 屬性的容器，並將 StandardBlobTier 設定為 Cool。 此命令會透過 [System.Web.MimeMapping]：：GetMimeMapping（） API，取得設定為 Blob 屬性的 ContentType 值。

範例 7：將檔案上傳至具有加密範圍的 Blob

$blob = Set-AzStorageBlobContent  -File "mylocalfile" -Container "mycontainer" -Blob "myblob"  -EncryptionScope "myencryptscope"

$blob.BlobProperties.EncryptionScope

myencryptscope

此命令會將檔案上傳至具有加密範圍的 Blob。

參數

-AsJob

在背景中執行 Cmdlet。

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

-Blob

指定 Blob 的名稱。 此 Cmdlet 會將檔案上傳至此參數所指定的 Azure 儲存體 Blob。

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

-BlobType

指定此 Cmdlet 上傳之 Blob 的類型。 此參數可接受的值為：

  • 封鎖
  • 頁
  • 附加

預設值為 Block。

Type:String
Accepted values:Block, Page, Append
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientTimeoutPerRequest

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

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

指定 CloudBlob 物件。 若要取得 CloudBlob 物件，請使用 Get-Az 儲存體 Blob Cmdlet。

Type:CloudBlob
Aliases:ICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

從 Azure 儲存體 客戶端連結庫指定 CloudBlobContainer 物件。 此 Cmdlet 會將內容上傳至這個參數所指定容器中的 Blob。 若要取得 CloudBlobContainer 物件，請使用 Get-Az 儲存體 Container Cmdlet。

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

-ConcurrentTaskCount

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

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

指定容器的名稱。 這個 Cmdlet 會將檔案上傳至這個參數所指定容器中的 Blob。

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

-Context

指定 Azure 記憶體內容。 若要取得記憶體內容，請使用 New-Az 儲存體 Context Cmdlet。 若要在沒有讀取許可權的情況下，使用從 SAS 令牌建立的記憶體內容，需要新增 -Force 參數來略過檢查 Blob 是否存在。

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionScope

對 Blob 提出要求時要使用的加密範圍。

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

-File

指定要上傳為 Blob 內容的檔案本機檔案路徑。

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

-Force

指出此 Cmdlet 會覆寫現有的 Blob，而不會提示您進行確認。

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

-Metadata

指定上傳之 Blob 的元數據。

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

-PremiumPageBlobTier

分頁 Blob 層

Type:PremiumPageBlobTier
Accepted values:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Properties

指定上傳之 Blob 的屬性。 支持的屬性包括：CacheControl、ContentDisposition、ContentEncoding、ContentLanguage、ContentMD5、ContentType。

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

-ServerTimeoutPerRequest

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

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StandardBlobTier

區塊 Blob 層，有效值為經常性存取/非經常性存取/封存/冷。 請參閱 中的詳細數據 https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

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

-Tag

Blob 標記

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

-TagCondition

要檢查比對條件的選擇性標記表達式語句。 Blob 標籤不符合指定表示式時，Blob 要求將會失敗。 請參閱 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations 中的詳細資料。

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

CloudBlobContainer

CloudBlob

IStorageContext

輸出

AzureStorageBlob