Set-AzStorageBlobContent
ローカル ファイルを Azure Storage BLOB にアップロードします。
構文
SendManual (既定)
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>]
ContainerPipeline
Set-AzStorageBlobContent
[-File] <String>
-CloudBlobContainer <CloudBlobContainer>
[-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>]
BlobPipeline
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
バックグラウンドでコマンドレットを実行します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Blob
BLOB の名前を指定します。
このコマンドレットは、このパラメーターで指定されたファイルを Azure Storage BLOB にアップロードします。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
SendManual
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
ContainerPipeline
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-BlobType
このコマンドレットがアップロードする BLOB の種類を指定します。
このパラメーターに使用できる値は次のとおりです。
既定値は Block です。
パラメーターのプロパティ
型: | String
|
規定値: | None |
指定可能な値: | Block, Page, Append |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ClientTimeoutPerRequest
1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。
指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。
間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。
パラメーターのプロパティ
型: | Nullable<T>[Int32]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ClientTimeoutPerRequestInSeconds |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-CloudBlob
CloudBlob オブジェクト 指定します。
CloudBlob オブジェクトを取得するには、Get-AzStorageBlob コマンドレットを使用します。
パラメーターのプロパティ
型: | Microsoft.Azure.Storage.Blob.CloudBlob
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ICloudBlob |
パラメーター セット
BlobPipeline
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-CloudBlobContainer
Azure Storage クライアント ライブラリの CloudBlobContainer オブジェクトを指定します。
このコマンドレットは、このパラメーターが指定するコンテナー内の BLOB にコンテンツをアップロードします。
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 |
パラメーター セット
SendManual
配置: | 1 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Context
Azure ストレージ コンテキストを指定します。
ストレージ コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。
読み取りアクセス許可なしで SAS トークンから作成されたストレージ コンテキストを使用するには、-Force パラメーターを追加して BLOB の存在の確認をスキップする必要があります。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-EncryptionScope
BLOB への要求を行うときに使用される暗号化スコープ。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-File
BLOB コンテンツとしてアップロードするファイルのローカル ファイル パスを指定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | 氏名 |
パラメーター セット
SendManual
配置: | 0 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-Force
このコマンドレットは、確認を求めずに既存の BLOB を上書きすることを示します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
アップロードされた BLOB のメタデータを指定します。
型: | Hashtable
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-PremiumPageBlobTier
ページ BLOB 層
パラメーターのプロパティ
型: | Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
|
規定値: | None |
指定可能な値: | Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80 |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Properties
アップロードされた BLOB のプロパティを指定します。
サポートされているプロパティは、CacheControl、ContentDisposition、ContentEncoding、ContentLanguage、ContentMD5、ContentType です。
パラメーターのプロパティ
型: | Hashtable
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ServerTimeoutPerRequest
要求のサービス側のタイムアウト間隔を秒単位で指定します。
サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。
パラメーターのプロパティ
型: | Nullable<T>[Int32]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ServerTimeoutPerRequestInSeconds |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-StandardBlobTier
ブロック BLOB 層。有効な値はホット/クール/アーカイブ/コールドです。
詳細については、以下を参照してください。 https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Tag
BLOB タグ
パラメーターのプロパティ
型: | Hashtable
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(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.CloudBlobContainer
Microsoft.Azure.Storage.Blob.CloudBlob
出力