Set-AzStorageFileContent
構文
ShareName (既定)
Set-AzStorageFileContent
[-ShareName] <String>
[-Source] <String>
[[-Path] <String>]
[-FileMode <String>]
[-Owner <String>]
[-Group <String>]
[-PassThru]
[-Force]
[-AsJob]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Share
Set-AzStorageFileContent
[-ShareClient] <ShareClient>
[-Source] <String>
[[-Path] <String>]
[-FileMode <String>]
[-Owner <String>]
[-Group <String>]
[-PassThru]
[-Force]
[-AsJob]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[-PreserveSMBAttribute]
[<CommonParameters>]
Directory
Set-AzStorageFileContent
[-ShareDirectoryClient] <ShareDirectoryClient>
[-Source] <String>
[[-Path] <String>]
[-FileMode <String>]
[-Owner <String>]
[-Group <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 -ShareClient $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 ファイルにアップロードし、ローカルファイル SMB プロパティ (ファイル属性、ファイル作成時刻、ファイル最終書き込み時刻) を Azure ファイルに保持します。
Set-AzStorageFileContent -Source $localFilePath -ShareName sample -Path "dir1/file1" -PreserveSMBAttribute
次の使用例は、ローカル ファイルを Azure ファイルにアップロードし、Azure ファイルのローカル ファイル SMB プロパティ (ファイル属性、ファイル作成時刻、ファイルの最終書き込み時刻) を保持します。
例 4: FileMode、所有者、およびグループを含むファイルを NFS ファイル共有にアップロードする
Set-AzStorageFileContent -ShareName "contososhare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile" -FileMode rw-r--rwt -Owner 1 -Group 1
このコマンドは、FileMode rwxrwSrwx、Owner 1、および Group 1 を使用して、ローカル ファイルを Azure ファイルにアップロードします。
FileMode、所有者、グループは NFS ファイル共有でのみ機能します。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ClientTimeoutPerRequest
1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。
指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。
間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。
パラメーターのプロパティ
型: | Nullable<T>[Int32]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ClientTimeoutPerRequestInSeconds |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ConcurrentTaskCount
同時ネットワーク呼び出しの最大数を指定します。
このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。
指定した値は絶対カウントであり、コア数には乗算されません。
このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。
既定値は 10 です。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Context
Azure ストレージ コンテキストを指定します。
ストレージ コンテキストを取得するには、 New-AzStorageContext コマンドレットを使用します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DisAllowTrailingDot
末尾のドット (.) をディレクトリ名とファイル名にサフィックス付けしないようにします。
パラメーターのプロパティ
パラメーター セット
ShareName
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-FileMode
NFS ファイルにのみ適用されます。 ファイルに設定するモードのアクセス許可。 シンボリック (rwxrw-rw-) がサポートされています。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Force
このコマンドレットが既存の Azure ストレージ ファイルを上書きすることを示します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Group
NFS ファイルにのみ適用されます。 ファイルに設定する所有者グループ識別子 (GID)。 既定値は 0 (ルート グループ) です。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Owner
NFS ファイルにのみ適用されます。 ファイルに設定する所有者ユーザー識別子 (UID)。 既定値は 0 (ルート) です。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-PassThru
このコマンドレットは、作成またはアップロードする azureStorageFile オブジェクト 返されることを示します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Path
ファイルまたはフォルダーのパスを指定します。
このコマンドレットは、このパラメーターが指定するファイル、またはこのパラメーターが指定するフォルダー内のファイルにコンテンツをアップロードします。
フォルダーを指定すると、このコマンドレットはソース ファイルと同じ名前のファイルを作成します。
存在しないファイルのパスを指定した場合、このコマンドレットはそのファイルを作成し、そのファイルに内容を保存します。
既に存在するファイルを指定し、Force パラメーターを指定すると、このコマンドレットによってファイルの内容が上書きされます。
既に存在するファイルを指定し、Forceを指定しない場合、このコマンドレットは変更を加えず、エラーを返します。
存在しないフォルダーのパスを指定すると、このコマンドレットは変更を行わないので、エラーが返されます。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | 2 |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-PreserveSMBAttribute
コピー元のファイル SMB プロパティ (ファイル属性、ファイル作成時刻、ファイルの最終書き込み時刻) をコピー先ファイルに保持します。 このパラメーターは Windows でのみ使用できます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ServerTimeoutPerRequest
要求のサーバー部分のタイムアウト期間の長さを指定します。
パラメーターのプロパティ
型: | Nullable<T>[Int32]
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ServerTimeoutPerRequestInSeconds |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ShareClient
ShareClient オブジェクトは、ファイルのアップロード先となる共有を示しました。
パラメーターのプロパティ
型: | ShareClient
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
Share
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-ShareDirectoryClient
ShareDirectoryClient オブジェクトは、ファイルがアップロードされるディレクトリを示しました。
パラメーターのプロパティ
パラメーター セット
Directory
配置: | 0 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-ShareName
ファイル共有の名前を指定します。
このコマンドレットは、このパラメーターで指定したファイル共有内のファイルにアップロードします。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
ShareName
配置: | 0 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Source
このコマンドレットがアップロードするソース ファイルを指定します。
存在しないファイルを指定すると、このコマンドレットはエラーを返します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | 氏名 |
パラメーター セット
(All)
配置: | 1 |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | 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を参照してください。
出力