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

Get-AzureStorageFile

参考

模块:: Azure.Storage

列出路径的目录和文件。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器（ARM）资源。

语法

Get-AzureStorageFile
   [-ShareName] <String>
   [[-Path] <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzureStorageFile
   [-Share] <CloudFileShare>
   [[-Path] <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzureStorageFile
   [-Directory] <CloudFileDirectory>
   [[-Path] <String>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

说明

Get-AzureStorageFile cmdlet 列出了指定的共享或目录的目录和文件。指定 Path 参数以获取指定路径中的目录或文件的实例。

此 cmdlet 返回 AzureStorageFile 和 AzureStorageDirectory 对象。可以使用 IsDirectory 属性区分文件夹和文件。

示例

示例 1：列出共享中的目录

PS C:\>Get-AzureStorageFile -ShareName "share1" | where {$_.GetType().Name -eq "CloudFileDirectory"}

此命令仅列出共享 ContosoShare06 中的目录。它首先检索文件和目录，使用管道运算符将它们 传递给 where 运算符，然后丢弃类型不是“CloudFileDirectory”的任何对象。

示例 2：列出文件目录

PS C:\> Get-AzureStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzureStorageFile

此命令在 Share ContosoShare06 下的目录 ContosoWorkingFolder 中列出文件和文件夹。它首先获取目录实例，然后将其管道传递给 Get-AzureStorageFile cmdlet 以列出目录。

参数

-ClientTimeoutPerRequest

指定一个服务请求的客户端超时间隔（以秒为单位）。如果上一次调用在指定的时间间隔内失败，则此 cmdlet 将重试请求。如果此 cmdlet 在间隔过前未收到成功的响应，则此 cmdlet 将返回错误。

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

-ConcurrentTaskCount

指定最大并发网络调用数。可以使用此参数通过指定并发网络调用的最大数目来限制本地 CPU 和带宽使用量的并发性。指定的值是绝对计数，不乘以核心计数。此参数可以帮助缓解低带宽环境中的网络连接问题，例如每秒 100 千比特。默认值为 10。

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

-Context

指定Azure 存储上下文。若要获取存储上下文，请使用 New-AzureStorageContext cmdlet。

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

-Directory

将文件夹指定为 CloudFileDirectory 对象。此 cmdlet 获取此参数指定的文件夹。若要获取目录，请使用 New-AzureStorageDirectory cmdlet。还可以使用 Get-AzureStorageFile cmdlet 获取目录。

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

-Path

指定文件夹的路径。

如果省略 Path 参数， Get-AzureStorageFile 会列出指定文件共享或目录中的目录和文件。如果包含 Path 参数， Get-AzureStorageFile 将返回指定路径中的目录或文件的实例。

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

-ServerTimeoutPerRequest

指定请求的服务端超时间隔（以秒为单位）。如果服务处理请求之前指定的间隔已过，则存储服务将返回错误。

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

指定 CloudFileShare 对象。此 cmdlet 从此参数指定的文件共享中获取文件或目录。若要获取 CloudFileShare 对象，请使用 Get-AzureStorageShare cmdlet。此对象包含存储上下文。如果指定此参数，请不要指定 Context 参数。

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

-ShareName

指定文件共享的名称。此 cmdlet 从此参数指定的文件共享中获取文件或目录。

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

通过