Set-AzStorageFileContent

リファレンス

モジュール:: Az.Storage

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

構文

Set-AzStorageFileContent
   [-ShareName] <String>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Set-AzStorageFileContent
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Set-AzStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

説明

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

例

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

Set-AzStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"

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

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

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

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

例 3: ローカルファイルを Azure ファイルにアップロードし、Azure ファイルのローカルファイル S MB (メガバイト) プロパティ (ファイル属性、ファイル作成時刻、ファイル最終書き込み時刻) を指定します。

Set-AzStorageFileContent -Source $localFilePath -ShareName sample -Path "dir1/file1" -PreserveSMBAttribute

次の使用例は、ローカルファイルを Azure ファイルにアップロードし、Azure ファイルのローカルファイル S MB (メガバイト) プロパティ (ファイル属性、ファイル作成時刻、最終書き込み時刻) を設定します。

パラメーター

-AsJob

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

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

-ClientTimeoutPerRequest

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

Type:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConcurrentTaskCount

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

Type:	Nullable<T>[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

-Context

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

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

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Directory

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

Type:	CloudFileDirectory
Aliases:	CloudFileDirectory
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DisAllowTrailingDot

末尾のドット (.) をディレクトリ名とファイル名にサフィックス付けしないようにします。

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

-Force

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

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

-PassThru

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

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

-Path

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

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

-PreserveSMBAttribute

コピー元ファイルの S MB (メガバイト) プロパティ (ファイル属性、ファイル作成時刻、ファイルの最終書き込み時刻) をコピー先ファイルに保持します。このパラメーターは Windows でのみ使用できます。

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

-ServerTimeoutPerRequest

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

Type:	Nullable<T>[Int32]
Aliases:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Type:	CloudFileShare
Aliases:	CloudFileShare
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ShareClient

ShareClient オブジェクトは、ファイルのアップロード先となる共有を示しました。

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

-ShareDirectoryClient

CloudFileDirectory オブジェクトは、ファイルがアップロードされるクラウドディレクトリを示しました。

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

-ShareName

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

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

-Source

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

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

-WhatIf

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

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

入力

CloudFileShare

CloudFileDirectory

String

IStorageContext

出力

AzureStorageFile

Set-AzStorageFileContent

構文

説明

例

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

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

例 3: ローカルファイルを Azure ファイルにアップロードし、Azure ファイルのローカルファイル S MB (メガバイト) プロパティ (ファイル属性、ファイル作成時刻、ファイル最終書き込み時刻) を指定します。

パラメーター

-AsJob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-Directory

-DisAllowTrailingDot

-Force

-PassThru

-Path

-PreserveSMBAttribute

-ServerTimeoutPerRequest

-ShareClient

-ShareDirectoryClient

-ShareName

-Source

-WhatIf

入力

出力

フィードバック

その他のリソース

Set-AzStorageFileContent

構文

説明

例

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

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

例 3: ローカル ファイルを Azure ファイルにアップロードし、Azure ファイルのローカル ファイル S MB (メガバイト) プロパティ (ファイル属性、ファイル作成時刻、ファイル最終書き込み時刻) を指定します。

パラメーター

-AsJob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-Directory

-DisAllowTrailingDot

-Force

-PassThru

-Path

-PreserveSMBAttribute

-ServerTimeoutPerRequest

-Share

-ShareClient

-ShareDirectoryClient

-ShareName

-Source

-WhatIf

入力

出力

関連リンク

フィードバック

その他のリソース

例 3: ローカルファイルを Azure ファイルにアップロードし、Azure ファイルのローカルファイル S MB (メガバイト) プロパティ (ファイル属性、ファイル作成時刻、ファイル最終書き込み時刻) を指定します。