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

Get-AzStorageShare

获取文件共享的列表。

语法

Get-AzStorageShare
   [[-Prefix] <String>]
   [-IncludeDeleted]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageShare
   [-Name] <String>
   [[-SnapshotTime] <DateTimeOffset>]
   [-SkipGetProperty]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

说明

Get-AzStorageShare cmdlet 获取存储帐户的文件共享列表。

示例

示例 1:获取文件共享

Get-AzStorageShare -Name "ContosoShare06"

此命令获取名为 ContosoShare06 的文件共享。

示例 2:获取以字符串开头的所有文件共享

Get-AzStorageShare -Prefix "Contoso"

此命令获取所有以 Contoso 开头的名称的文件共享。

示例 3:获取指定上下文中的所有文件共享

$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $Context

第一个命令使用 New-AzStorageContext cmdlet 通过 Local 参数创建上下文,然后将该上下文对象存储在$Context变量中。 第二个命令获取存储在$Context中的上下文对象的文件共享。

示例 4:获取具有特定共享名称和 SnapshotTime 的文件共享快照

Get-AzStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

此命令获取具有特定共享名称和 SnapshotTime 的文件共享快照。

示例 5:使用 OAuth 身份验证获取不提取共享属性的文件共享对象。

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
$share = Get-AzStorageShare -Name "ContosoShare06" -SkipGetProperty -Context $ctx

此命令获取文件共享快照,而无需通过 OAuth 身份验证获取共享属性。 使用 OAuth 身份验证获取共享属性将失败,因为 API 不支持 OAuth。 因此,若要使用 OAuth 身份验证获取共享对象,必须跳过提取共享属性。

参数

-ClientTimeoutPerRequest

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

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

-ConcurrentTaskCount

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

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

-Context

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

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

-DefaultProfile

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

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

-IncludeDeleted

包括已删除的共享,默认情况下,获取共享不包括已删除的共享

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

-Name

指定文件共享的名称。 此 cmdlet 获取此参数指定的文件共享;如果未指定不存在的文件共享的名称,则不执行任何操作。

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

-Prefix

指定文件共享的前缀。 此 cmdlet 获取与此参数指定的前缀匹配的文件共享;如果没有与指定前缀匹配的文件共享,则不获取文件共享。

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

-ServerTimeoutPerRequest

指定请求的服务器部分超时期限的长度。

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

-SkipGetProperty

指定此参数以仅生成本地共享对象,而不从服务器获取共享属性。

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

-SnapshotTime

要接收的文件共享快照的 SnapshotTime。

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

输入

IStorageContext

输出

AzureStorageFileShare