Set-AzureStorageFileContent

ファイルの内容をアップロードします。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Set-AzureStorageFileContent
   [-ShareName] <String>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzureStorageFileContent コマンドレットは、指定した共有上のファイルにファイルの内容をアップロードします。

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

PS C:\>Set-AzureStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"

このコマンドは、現在のフォルダー内の DataFile37 という名前のファイルを、ContosoWorkingFolder という名前のフォルダー内の CurrentDataFile という名前のファイルとしてアップロードします。

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

PS C:\>$CurrentFolder = (Get-Item .).FullName
PS C:\> $Container = Get-AzureStorageShare -Name "ContosoShare06"
PS C:\> Get-ChildItem -Recurse | Where-Object { $_.GetType().Name -eq "FileInfo"} | ForEach-Object {
    $path=$_.FullName.Substring($Currentfolder.Length+1).Replace("\","/")
    Set-AzureStorageFileContent -Share $Container -Source $_.FullName -Path $path -Force
}

この例では、いくつかの一般的な Windows PowerShell コマンドレットと現在のコマンドレットを使用して、現在のフォルダーからコンテナー ContosoShare06 のルート フォルダーにすべてのファイルをアップロードします。 最初のコマンドは、現在のフォルダーの名前を取得し、$CurrentFolder変数に格納します。 2 番目の コマンドでは、Get-AzureStorageShare コマンドレットを使用して ContosoShare06 という名前のファイル共有を取得し、$Container変数に格納します。 最後のコマンドは、現在のフォルダーの内容を取得し、パイプライン演算子を使用して各フォルダーを Where-Object コマンドレットに渡します。 このコマンドレットは、ファイルではないオブジェクトを除外し、ForEach-Object コマンドレットにファイルを渡します。 このコマンドレットは、ファイルごとにスクリプト ブロックを実行し、そのファイルに適切なパスを作成し、現在のコマンドレットを使用してファイルをアップロードします。 この例でアップロードする他のファイルに関して、結果の名前と相対位置は同じです。 スクリプト ブロックの詳細については、「.」と入力します Get-Help about_Script_Blocks

パラメーター

-ClientTimeoutPerRequest

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

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

-ConcurrentTaskCount

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

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

-Confirm

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

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

-Context

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

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

-DefaultProfile

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

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

-Directory

フォルダーを CloudFileDirectory オブジェクトとして指定します。 このコマンドレットは、このパラメーターが指定したフォルダーにファイルをアップロードします。 ディレクトリを取得するには、New-AzureStorageDirectory コマンドレットを使用します。 Get-AzureStorageFile コマンドレットを使用してディレクトリを取得することもできます。

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

-Force

このコマンドレットが既存の Azure ストレージ ファイルを上書きすることを示します。

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

-PassThru

このコマンドレットは、作成またはアップロードする AzureStorageFile オブジェクトを返します。

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

-Path

ファイルまたはフォルダーのパスを指定します。 このコマンドレットは、このパラメーターが指定するファイル、またはこのパラメーターが指定するフォルダー内のファイルにコンテンツをアップロードします。 フォルダーを指定すると、このコマンドレットはソース ファイルと同じ名前のファイルを作成します。 存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、そのファイルに内容を保存します。 既に存在するファイルを指定し、Force パラメーターを指定すると、このコマンドレットによってファイルの内容が上書きされます。 既に存在するファイルを指定し、Force を指定しない場合、このコマンドレットは変更を加えず、エラーを返します。 存在しないフォルダーのパスを指定すると、このコマンドレットは変更を行わないので、エラーが返されます。

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

-ServerTimeoutPerRequest

要求のサーバー部分のタイムアウト期間の長さを指定します。

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

-Share

CloudFileShare オブジェクトを指定します。 このコマンドレットは、このパラメーターで指定したファイル共有内のファイルにアップロードします。 CloudFileShare オブジェクトを取得するには、Get-AzureStorageShare コマンドレットを使用します。 このオブジェクトには、ストレージ コンテキストが含まれています。 このパラメーターを指定する場合は、Context パラメーターを指定しないでください。

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

-ShareName

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

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

-Source

このコマンドレットがアップロードするソース ファイルを指定します。 存在しないファイルを指定すると、このコマンドレットはエラーを返します。

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

-WhatIf

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

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

入力

CloudFileShare

パラメーター: 共有 (ByValue)

CloudFileDirectory

パラメーター: ディレクトリ (ByValue)

String

IStorageContext

出力

CloudFile