次の方法で共有

Set-AzureStorageBlobContent

  • リファレンス
モジュール:
Azure.Storage

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

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

Set-AzureStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-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: ファイルとメタデータをアップロードする

PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata

最初のコマンドは、BLOB のメタデータを含むハッシュ テーブルを作成し、そのハッシュ テーブルを $Metadata 変数に格納します。

2 番目のコマンドは、ContosoPlanning という名前のファイルを ContosoUploads という名前のコンテナーにアップロードします。 BLOB には、$Metadataに格納されているメタデータが含まれます。

パラメーター

-Blob

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

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

-BlobType

このコマンドレットがアップロードする 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

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

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

-CloudBlob

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

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

-CloudBlobContainer

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

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

-ConcurrentTaskCount

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

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

-Confirm

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

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

-Container

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

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

-Context

Azure ストレージ コンテキストを指定します。 ストレージ コンテキストを取得するには、New-AzureStorageContext コマンドレットを使用します。

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

このコマンドレットは、確認を求めずに既存の 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

-Properties

アップロードされた BLOB のプロパティを指定します。

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

-ServerTimeoutPerRequest

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

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

-WhatIf

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

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