Set-AzStorageBlobContent

ローカル ファイルを Azure Storage BLOB にアップロードします。

構文

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>]

説明

Set-AzStorageBlobContent コマンドレットは、ローカル ファイルを Azure Storage BLOB にアップロードします。

例 1: 名前付きファイルをアップロードする

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

このコマンドは、PlanningData という名前のファイルを Planning2015 という名前の BLOB にアップロードします。

例 2: 現在のフォルダーのすべてのファイルをアップロードする

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

このコマンドは、コア Windows PowerShell コマンドレット Get-ChildItem を使用して、現在のフォルダーとサブフォルダー内のすべてのファイルを取得し、パイプライン 演算子を使用して現在のコマンドレットに渡します。 Set-AzStorageBlobContent コマンドレットは、ContosoUploads という名前のコンテナーにファイルをアップロードします。

例 3: 既存の BLOB を上書きする

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

このコマンドは、Get-AzStorageBlob コマンドレットを使用して ContosoUploads コンテナー内の Planning2015 という名前の BLOB を取得し、その BLOB を現在のコマンドレットに渡します。 このコマンドは、ContosoPlanning という名前のファイルを Planning2015 としてアップロードします。 このコマンドでは、 Force パラメーターは指定されません。 コマンドを実行すると、確認を求められます。 コマンドを確認すると、コマンドレットによって既存の BLOB が上書きされます。

例 4: パイプラインを使用してコンテナーにファイルをアップロードする

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

このコマンドは、 Get-AzStorageContainer コマンドレットを使用して ContosoUpload という文字列で始まるコンテナーを取得し、その BLOB を現在のコマンドレットに渡します。 このコマンドは、ContosoPlanning という名前のファイルを Planning2015 としてアップロードします。

例 5: メタデータを含むページ BLOB にファイルをアップロードし、PremiumPageBlobTier を P10 としてアップロードする

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

最初のコマンドは、BLOB のメタデータを含むハッシュ テーブルを作成し、そのハッシュ テーブルを $Metadata 変数に格納します。 2 番目のコマンドは、ContosoPlanning という名前のファイルを ContosoUploads という名前のコンテナーにアップロードします。 BLOB には、$Metadataに格納されているメタデータが含まれており、PremiumPageBlobTier は 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

このコマンドは、指定された BLOB プロパティを持つ contosouploads という名前のコンテナーに c:\temp\index.html ファイルをアップロードし、StandardBlobTier をクールとして設定します。 このコマンドは、[System.Web.MimeMapping]::GetMimeMapping() API によって ContentType 値を BLOB プロパティに設定します。

例 7: 暗号化スコープを持つ BLOB にファイルをアップロードする

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

$blob.BlobProperties.EncryptionScope

myencryptscope

このコマンドは、暗号化スコープを持つ BLOB にファイルをアップロードします。

パラメーター

-AsJob

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Blob

BLOB の名前を指定します。 このコマンドレットは、このパラメーターで指定されたファイルを Azure Storage BLOB にアップロードします。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BlobType

このコマンドレットがアップロードする BLOB の種類を指定します。 このパラメーターの有効値は、次のとおりです。

  • ブロック
  • ページ
  • 追加

既定値は [ブロック] です。

型:String
指定可能な値:Block, Page, Append
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClientTimeoutPerRequest

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

型:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CloudBlob

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

型:CloudBlob
Aliases:ICloudBlob
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-CloudBlobContainer

Azure Storage クライアント ライブラリの CloudBlobContainer オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するコンテナー内の BLOB にコンテンツをアップロードします。 CloudBlobContainer オブジェクトを取得するには、Get-AzStorageContainer コマンドレットを使用します。

型:CloudBlobContainer
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ConcurrentTaskCount

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

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Container

コンテナーの名前を指定します。 このコマンドレットは、このパラメーターが指定するコンテナー内の BLOB にファイルをアップロードします。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Context

Azure ストレージ コンテキストを指定します。 ストレージ コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。 読み取りアクセス許可なしで SAS トークンから作成されたストレージ コンテキストを使用するには、-Force パラメーターを追加して BLOB の存在の確認をスキップする必要があります。

型:IStorageContext
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EncryptionScope

BLOB への要求を行うときに使用される暗号化スコープ。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-File

BLOB コンテンツとしてアップロードするファイルのローカル ファイル パスを指定します。

型:String
Aliases:FullName
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Force

このコマンドレットは、確認を求めずに既存の BLOB を上書きすることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Metadata

アップロードされた BLOB のメタデータを指定します。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PremiumPageBlobTier

ページ BLOB 層

型:PremiumPageBlobTier
指定可能な値:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Properties

アップロードされた BLOB のプロパティを指定します。 サポートされているプロパティは、CacheControl、ContentDisposition、ContentEncoding、ContentLanguage、ContentMD5、ContentType です。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServerTimeoutPerRequest

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

型:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-StandardBlobTier

ブロック BLOB 層。有効な値はホット/クール/アーカイブ/コールドです。 詳細については、以下を参照してください。 https://video2.skills-academy.com/azure/storage/blobs/storage-blob-storage-tiers

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Tag

BLOB タグ

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TagCondition

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

CloudBlobContainer

CloudBlob

IStorageContext

出力

AzureStorageBlob