你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Get-AzureStorageFileContent
下载文件的内容。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用。
Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。
语法
Get-AzureStorageFileContent
[-ShareName] <String>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzureStorageFileContent
[-Share] <CloudFileShare>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzureStorageFileContent
[-Directory] <CloudFileDirectory>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzureStorageFileContent
[-File] <CloudFile>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Get-AzureStorageFileContent cmdlet 下载文件的内容,然后将其保存到指定的目标。 此 cmdlet 不返回文件的内容。
示例
示例 1:从文件夹下载文件
PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"
此命令将 ContosoWorkingFolder 文件夹中名为 CurrentDataFile 的文件从文件共享 ContosoShare06 下载到当前文件夹。
参数
-CheckMd5
如果指定不存在的文件的路径,此 cmdlet 将创建该文件,并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径,则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force,则 cmdlet 会在继续之前提示你。
如果指定文件夹的路径,此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ClientTimeoutPerRequest
如果指定不存在的文件的路径,此 cmdlet 将创建该文件,并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径,则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force,则 cmdlet 会在继续之前提示你。
如果指定文件夹的路径,此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ConcurrentTaskCount
如果指定不存在的文件的路径,此 cmdlet 将创建该文件,并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径,则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force,则 cmdlet 会在继续之前提示你。
如果指定文件夹的路径,此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Context
如果指定不存在的文件的路径,此 cmdlet 将创建该文件,并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径,则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force,则 cmdlet 会在继续之前提示你。
如果指定文件夹的路径,此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。
类型: | IStorageContext |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Destination
指定目标路径。 此 cmdlet 会将文件内容下载到此参数指定的位置。
如果指定不存在的文件的路径,此 cmdlet 将创建该文件,并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径,则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force,则 cmdlet 会在继续之前提示你。
如果指定文件夹的路径,此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。
类型: | String |
Position: | 2 |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Directory
将文件夹指定为 CloudFileDirectory 对象。 此 cmdlet 获取此参数指定的文件夹中文件的内容。 若要获取目录,请使用 New-AzureStorageDirectory cmdlet。 还可以使用 Get-AzureStorageFile cmdlet 获取目录。
类型: | CloudFileDirectory |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-File
将文件指定为 CloudFile 对象。 此 cmdlet 获取此参数指定的文件。 若要获取 CloudFile 对象,请使用 Get-AzureStorageFile cmdlet。
类型: | CloudFile |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Force
如果指定不存在的文件的路径,此 cmdlet 将创建该文件,并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径,则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force,则 cmdlet 会在继续之前提示你。
如果指定文件夹的路径,此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-PassThru
如果指定不存在的文件的路径,此 cmdlet 将创建该文件,并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径,则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force,则 cmdlet 会在继续之前提示你。
如果指定文件夹的路径,此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Path
指定文件路径。 此 cmdlet 获取此参数指定的文件的内容。 如果文件不存在,则此 cmdlet 将返回错误。
类型: | String |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-ServerTimeoutPerRequest
如果指定不存在的文件的路径,此 cmdlet 将创建该文件,并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径,则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force,则 cmdlet 会在继续之前提示你。
如果指定文件夹的路径,此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Share
指定 CloudFileShare 对象。 此 cmdlet 下载共享中文件的内容,此参数指定。 若要获取 CloudFileShare 对象,请使用 Get-AzureStorageShare cmdlet。 此对象包含存储上下文。 如果指定此参数,请不要指定 Context 参数。
类型: | CloudFileShare |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-ShareName
指定文件共享的名称。 此 cmdlet 下载共享中文件的内容,此参数指定。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |