Set-AzureStorageBlobContent
ローカル ファイルを Azure Storage BLOB にアップロードします。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Set-AzureStorageBlobContent
[-File] <String>
[-Container] <String>
[-Blob <String>]
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-Force]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureStorageBlobContent
[-File] <String>
[-Blob <String>]
-CloudBlobContainer <CloudBlobContainer>
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-Force]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureStorageBlobContent
[-File] <String>
-CloudBlob <CloudBlob>
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-Force]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Set-AzureStorageBlobContent コマンドレットは、ローカル ファイルを Azure Storage BLOB にアップロードします。
例
例 1: 名前付きファイルをアップロードする
PS C:\>Set-AzureStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"このコマンドは、PlanningData という名前のファイルを Planning2015 という名前の BLOB にアップロードします。
例 2: 現在のフォルダーのすべてのファイルをアップロードする
PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -Container "ContosoUploads"このコマンドは、コア Windows PowerShell コマンドレット Get-ChildItem を使用して、現在のフォルダーとサブフォルダー内のすべてのファイルを取得し、パイプライン 演算子を使用して現在のコマンドレットに渡します。 Set-AzureStorageBlobContent コマンドレットは、ContosoUploads という名前のコンテナーにファイルをアップロードします。
例 3: 既存の BLOB を上書きする
PS C:\>Get-AzureStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzureStorageBlobContent -File "ContosoPlanning"このコマンドは、Get-AzureStorageBlob コマンドレットを使用して ContosoUploads コンテナー内の Planning2015 という名前の BLOB を取得し、その BLOB を現在のコマンドレットに渡します。 このコマンドは、ContosoPlanning という名前のファイルを Planning2015 としてアップロードします。 このコマンドでは、 Force パラメーターは指定されません。 コマンドを実行すると、確認を求められます。 コマンドを確認すると、コマンドレットによって既存の BLOB が上書きされます。
例 4: パイプラインを使用してコンテナーにファイルをアップロードする
PS C:\>Get-AzureStorageContainer -Container "ContosoUpload*" | Set-AzureStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"このコマンドは、 Get-AzureStorageContainer コマンドレットを使用して ContosoUpload という文字列で始まるコンテナーを取得し、その BLOB を現在のコマンドレットに渡します。 このコマンドは、ContosoPlanning という名前のファイルを Planning2015 としてアップロードします。
例 5: メタデータを含むページ BLOB にファイルをアップロードし、PremiumPageBlobTier を P10 としてアップロードする
PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10最初のコマンドは、BLOB のメタデータを含むハッシュ テーブルを作成し、そのハッシュ テーブルを $Metadata 変数に格納します。 2 番目のコマンドは、ContosoPlanning という名前のファイルを ContosoUploads という名前のコンテナーにアップロードします。 BLOB には、$Metadataに格納されているメタデータが含まれており、PremiumPageBlobTier は P10 です。
例 6: 指定された BLOB プロパティを使用して BLOB にファイルをアップロードする
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Properties @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="}このコマンドは、ContosoPlanning という名前のファイルを、指定された BLOB プロパティを持つ ContosoUploads という名前のコンテナーにアップロードします。
パラメーター
-Blob
BLOB の名前を指定します。 このコマンドレットは、このパラメーターで指定されたファイルを Azure Storage BLOB にアップロードします。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-BlobType
このコマンドレットがアップロードする BLOB の種類を指定します。 このパラメーターの有効値は、次のとおりです。
- ブロック
- Page 既定値は [ブロック] です。
| 型: | String |
| 指定可能な値: | Block, Page, Append |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ClientTimeoutPerRequest
1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。
| 型: | Nullable<T>[Int32] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CloudBlob
CloudBlob オブジェクトを指定します。 CloudBlob オブジェクトを取得するには、Get-AzureStorageBlob コマンドレットを使用します。
| 型: | CloudBlob |
| Aliases: | ICloudBlob |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-CloudBlobContainer
Azure Storage クライアント ライブラリの CloudBlobContainer オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するコンテナー内の BLOB にコンテンツをアップロードします。 CloudBlobContainer オブジェクトを取得するには、Get-AzureStorageContainer コマンドレットを使用します。
| 型: | 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-AzureStorageContext コマンドレットを使用します。 読み取りアクセス許可なしで SAS トークンから作成されたストレージ コンテキストを使用するには、チェック BLOB の存在をスキップする -Force パラメーターを追加する必要があります。
| 型: | IStorageContext |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
| 型: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| 配置: | 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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Properties
アップロードされた BLOB のプロパティを指定します。 サポートされているプロパティは、CacheControl、ContentDisposition、ContentEncoding、ContentLanguage、ContentMD5、ContentType です。
| 型: | Hashtable |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ServerTimeoutPerRequest
要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。
| 型: | Nullable<T>[Int32] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |