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

Get-AzStorageFile

  • 参考
模块:
Az.Storage

列出路径的目录和文件。

语法

Get-AzStorageFile
   [-ShareName] <String>
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageFile
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageFile
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

说明

Get-Az存储File cmdlet 列出了指定的共享或目录的目录和文件。 指定 Path 参数以获取指定路径中的目录或文件的实例。 此 cmdlet 返回 Azure存储File 和 Azure存储Directory 对象。 可以使用 IsDirectory 属性区分文件夹和文件。

示例

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

Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}

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

示例 2：列出文件目录

Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile

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

参数

-ClientTimeoutPerRequest

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

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

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

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

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

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

禁止尾随点 （.） 后缀目录和文件名。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeExtendedInfo

不包括扩展文件信息，如时间戳、ETag、属性、list 文件和 Directory 中的 permissionKey。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

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

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

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

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

ShareClient 对象指示将列出文件/目录的共享。

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

ShareDirectoryClient 对象指示将列出文件/目录的基文件夹。

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

输入

CloudFileShare

CloudFileDirectory

IStorageContext

输出

AzureStorageFile