你当前正在访问 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