你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Get-AzureStorageFile
列出路径的目录和文件。
警告
截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源。
语法
Get-AzureStorageFile
[-ShareName] <String>
[[-Path] <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Get-AzureStorageFile
[-Share] <CloudFileShare>
[[-Path] <String>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Get-AzureStorageFile
[-Directory] <CloudFileDirectory>
[[-Path] <String>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
说明
Get-Azure存储File cmdlet 列出了指定的共享或目录的目录和文件。 指定 Path 参数以获取指定路径中的目录或文件的实例。 此 cmdlet 返回 Azure存储File 和 Azure存储Directory 对象。 可以使用 IsDirectory 属性区分文件夹和文件。
示例
示例 1:列出共享中的目录
PS C:\>Get-AzureStorageFile -ShareName "ContosoShare06" | where {$_.GetType().Name -eq "CloudFileDirectory"}
此命令仅列出共享 ContosoShare06 中的目录。 它首先检索文件和目录,使用管道运算符将它们传递给 where 运算符,然后取消卡类型不是“CloudFileDirectory”的任何对象。
示例 2:列出文件目录
PS C:\> Get-AzureStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzureStorageFile
此命令在 Share ContosoShare06 下的目录 ContosoWorkingFolder 中列出文件和文件夹。 它首先获取目录实例,然后将其管道传递给 Get-Azure存储File cmdlet 以列出目录。
参数
-ClientTimeoutPerRequest
指定一个服务请求的客户端超时间隔(以秒为单位)。 如果上一次调用在指定的时间间隔内失败,则此 cmdlet 将重试请求。 如果此 cmdlet 在间隔过前未收到成功的响应,则此 cmdlet 将返回错误。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConcurrentTaskCount
指定最大并发网络调用数。 可以使用此参数通过指定并发网络调用的最大数目来限制本地 CPU 和带宽使用量的并发性。 指定的值是绝对计数,不乘以核心计数。 此参数可以帮助缓解低带宽环境中的网络连接问题,例如每秒 100 千比特。 默认值为 10。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
指定Azure 存储上下文。 若要获取存储上下文,请使用 New-Azure存储Context cmdlet。
类型: | IStorageContext |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Directory
将文件夹指定为 CloudFileDirectory 对象。 此 cmdlet 获取此参数指定的文件夹。 若要获取目录,请使用 New-Azure存储Directory cmdlet。 还可以使用 Get-Azure存储File cmdlet 获取目录。
类型: | CloudFileDirectory |
Position: | 0 |
默认值: | None |
必需: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
指定文件夹的路径。 如果省略 Path 参数,Get-Azure存储File 会列出指定文件共享或目录中的目录和文件。 如果包含 Path 参数,Get-Azure存储File 将返回指定路径中的目录或文件的实例。
类型: | String |
Position: | 1 |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerTimeoutPerRequest
指定请求的服务端超时间隔(以秒为单位)。 如果服务处理请求之前指定的间隔已过,存储服务将返回错误。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Share
指定 CloudFileShare 对象。 此 cmdlet 从此参数指定的文件共享中获取文件或目录。 若要获取 CloudFileShare 对象,请使用 Get-Azure存储Share cmdlet。 此对象包含存储上下文。 如果指定此参数,请不要指定 Context 参数。
类型: | CloudFileShare |
Position: | 0 |
默认值: | None |
必需: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareName
指定文件共享的名称。 此 cmdlet 从此参数指定的文件共享中获取文件或目录。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
参数:共享(ByValue)
参数:目录(ByValue)