你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-AzureStorageFileContent

模块:

Azure.Storage

下载文件的内容。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

Get-AzureStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Get-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Get-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Get-AzureStorageFileContent
   [-File] <CloudFile>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Get-Azure存储FileContent cmdlet 下载文件的内容，然后将其保存到指定的目标。 此 cmdlet 不返回文件的内容。

示例

示例 1：从文件夹下载文件

PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

此命令将 ContosoWorkingFolder 文件夹中名为 CurrentDataFile 的文件从文件共享 ContosoShare06 下载到当前文件夹。

示例 2：下载示例文件共享下的文件

PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent

此示例下载示例文件共享下的文件

参数

-CheckMd5

如果指定不存在的文件的路径，此 cmdlet 将创建该文件，并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径，则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force，则 cmdlet 会在继续之前提示你。 如果指定文件夹的路径，此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ClientTimeoutPerRequest

如果指定不存在的文件的路径，此 cmdlet 将创建该文件，并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径，则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force，则 cmdlet 会在继续之前提示你。 如果指定文件夹的路径，此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConcurrentTaskCount

如果指定不存在的文件的路径，此 cmdlet 将创建该文件，并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径，则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force，则 cmdlet 会在继续之前提示你。 如果指定文件夹的路径，此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Destination

指定目标路径。 此 cmdlet 会将文件内容下载到此参数指定的位置。 如果指定不存在的文件的路径，此 cmdlet 将创建该文件，并将内容保存在新文件中。 如果指定已存在且指定 Force 参数的文件的路径，则 cmdlet 将覆盖该文件。 如果指定现有文件的路径且未指定 Force，则 cmdlet 会在继续之前提示你。 如果指定文件夹的路径，此 cmdlet 将尝试创建一个名称为 Azure 存储文件的文件。

类型:	String
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Directory

将文件夹指定为 CloudFileDirectory 对象。 此 cmdlet 获取此参数指定的文件夹中文件的内容。 若要获取目录，请使用 New-Azure存储Directory cmdlet。 还可以使用 Get-Azure存储File cmdlet 获取目录。

类型:	CloudFileDirectory
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-File

将文件指定为 CloudFile 对象。 此 cmdlet 获取此参数指定的文件。 若要获取 CloudFile 对象，请使用 Get-Azure存储File 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 存储文件的文件。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Share

指定 CloudFileShare 对象。 此 cmdlet 下载共享中文件的内容，此参数指定。 若要获取 CloudFileShare 对象，请使用 Get-Azure存储Share 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

输入

CloudFileShare

参数：共享（ByValue）

CloudFileDirectory

参数：目录（ByValue）

CloudFile

参数：文件（ByValue）

IStorageContext

输出

CloudFile

相关链接

• Get-AzureStorageFile
• Set-AzureStorageFileContent