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 cmdlet 将文件的内容上传到指定共享上的文件。
示例
示例 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 cmdlet 和当前 cmdlet 将当前文件夹中的所有文件上传到容器 ContosoShare06 的根文件夹。
第一个命令获取当前文件夹的名称,并将其存储在$CurrentFolder变量中。
第二个命令使用 Get-AzStorageShare cmdlet 获取名为 ContosoShare06 的文件共享,然后将其存储在$Container变量中。
最后一个命令获取当前文件夹的内容,并使用管道运算符将每个内容传递给 Where-Object cmdlet。
该 cmdlet 会筛选出不是文件的对象,然后将文件传递到 ForEach-Object cmdlet。
该 cmdlet 为每个文件运行脚本块,该文件创建相应的路径,然后使用当前 cmdlet 上传文件。
结果与此示例上传的其他文件具有相同的名称和相对位置。
有关脚本块的详细信息,请键入 Get-Help about_Script_Blocks
。
示例 3:将本地文件上传到 Azure 文件,并在 Azure 文件中保留本地文件 SMB 属性(文件属性、文件创建时间、文件上次写入时间)。
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 和组 1 将本地文件上传到 Azure 文件。
FileMode、所有者、组仅适用于 NFS 文件共享。
参数
-AsJob
在后台运行 cmdlet。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-ClientTimeoutPerRequest
指定一个服务请求的客户端超时间隔(以秒为单位)。
如果上一次调用在指定的时间间隔内失败,则此 cmdlet 将重试请求。
如果此 cmdlet 在间隔过前未收到成功的响应,则此 cmdlet 将返回错误。
参数属性
类型: | Nullable<T>[Int32]
|
默认值: | None |
支持通配符: | False |
不显示: | False |
别名: | ClientTimeoutPerRequestInSeconds |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-ConcurrentTaskCount
指定最大并发网络调用数。
可以使用此参数通过指定并发网络调用的最大数目来限制本地 CPU 和带宽使用量的并发性。
指定的值是绝对计数,不乘以核心计数。
此参数可帮助减少低带宽环境中的网络连接问题,例如每秒 100 千比特。
默认值为 10。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Context
指定 Azure 存储上下文。
若要获取存储上下文,请使用 New-AzStorageContext cmdlet。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | True |
来自管道的值(按属性名称): | True |
来自剩余参数的值: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-DisAllowTrailingDot
禁止尾随点 (.) 后缀目录和文件名。
参数属性
参数集
ShareName
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-FileMode
仅适用于 NFS 文件。 要对文件设置的模式权限。 支持符号(rwxrw-rw-)。
参数属性
类型: | String
|
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Force
指示此 cmdlet 覆盖现有的 Azure 存储文件。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Group
仅适用于 NFS 文件。 要对文件设置的所有者组标识符(GID)。 默认值为 0(根组)。
参数属性
类型: | String
|
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Owner
仅适用于 NFS 文件。 要对文件设置的所有者用户标识符(UID)。 默认值为 0(root)。
参数属性
类型: | String
|
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-PassThru
指示此 cmdlet 返回它创建或上传的 AzureStorageFile 对象。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Path
指定文件或文件夹的路径。
此 cmdlet 将内容上传到此参数指定的文件,或上传到此参数指定的文件夹中的文件。
如果指定文件夹,此 cmdlet 将创建与源文件同名的文件。
如果指定不存在的文件的路径,此 cmdlet 将创建该文件并将内容保存到该文件。
如果指定已存在的文件,并且指定 Force 参数,则此 cmdlet 将覆盖文件的内容。
如果指定已存在且未指定 Force的文件,则此 cmdlet 不会进行更改,并返回错误。
如果指定不存在的文件夹的路径,则此 cmdlet 不会进行更改,并返回错误。
参数属性
类型: | String
|
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
(All)
Position: | 2 |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-PreserveSMBAttribute
将源文件 SMB 属性(文件属性、文件创建时间、文件上次写入时间)保留在目标文件中。 此参数仅在 Windows 上可用。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-ServerTimeoutPerRequest
指定请求的服务器部分超时期限的长度。
参数属性
类型: | Nullable<T>[Int32]
|
默认值: | None |
支持通配符: | False |
不显示: | False |
别名: | ServerTimeoutPerRequestInSeconds |
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-ShareClient
ShareClient 对象指示将文件上传到的共享。
参数属性
参数集
Share
Position: | 0 |
必需: | True |
来自管道的值: | True |
来自管道的值(按属性名称): | True |
来自剩余参数的值: | False |
-ShareDirectoryClient
ShareDirectoryClient 对象指示将上传文件的目录。
参数属性
参数集
Directory
Position: | 0 |
必需: | True |
来自管道的值: | True |
来自管道的值(按属性名称): | True |
来自剩余参数的值: | False |
-ShareName
指定文件共享的名称。
此 cmdlet 上传到文件共享中的文件,此参数指定。
参数属性
类型: | String
|
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
ShareName
Position: | 0 |
必需: | True |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Source
指定此 cmdlet 上传的源文件。
如果指定不存在的文件,则此 cmdlet 将返回错误。
参数属性
类型: | String
|
默认值: | None |
支持通配符: | False |
不显示: | False |
别名: | 全名 |
参数集
(All)
Position: | 1 |
必需: | True |
来自管道的值: | False |
来自管道的值(按属性名称): | True |
来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。
命令脚本未运行。
参数属性
参数集
(All)
Position: | Named |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输出